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The illustration on the following pages highlights the major body of documentation available for 
Cray Research (CRI) customers. The illustration is organized into categories by audience 
designation: 



Audience 
General users 

Application and 
system programmers 

System administrators 

System analysts 

Operators 



Description 

Those who use the UNICOS operating system, products, 
applications, or linking software 

Those who write or modify program code on a CRI system for the 
purpose of solving computer system, scientific, or engineering 
problems 

Those who perform system administration tasks, such as 
installation, configuration, and basic troubleshooting 

Those who perform advanced troubleshooting, tuning, and 
customization 

Those who perform operational functions, such as performing 
system dumps, and those who administer an operator workstation 



To use the map, find the audience designation closest to your specific needs or role as a CRI 
system user. Note that manuals under other audiences may also be of interest to you; manuals 
are listed only once, underneath the audience to which they most directly apply. Some manual 
titles are abbreviated. The date in the footer tells you when the information was last revised. 



For more information 

In addition to the illustration, you can use the following publications to find documentation 
specific to your needs: 

• Software Documentation Ready Reference, publication SQ-21 22, serves as a general index to 
the CRI documentation set. The booklet lists documents and man pages according to topic. 

• Software Overview for Users, publication SG-2052, introduces the UNICOS operating system, 
its features, and its related products. It directs you to documentation containing user-level 
information. 

• User Publications Catalog, publication CP-0099, briefly describes all CRI manuals available to 
you, including some not shown on the map, such as release notices and training workbooks. 



Ordering 

To obtain CRI publications, order them by publication number from the Distribution Center: 
Cray Research, Inc. 

Distribution Center Order desk (61 2) 681 -5907 

2360 Pilot Knob Road Fax number (61 2) 681 -5920 

Mendota Heights, MN 55120 
USA 
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Introductory 

UNICOS Primer 
(SG-2010)* 

Software Overview 
(SG-2052)* 

General 

Software Documentation 
Ready Reference* 
(SQ-2122) 

UNICOS Message 
Reference (SR-2200) 

User Commands 
Reference (SR-2011) § 



"V" 



User Commands Ready 
Reference (SQ-2056) 

UNICOS Shells Ready 
Reference (SQ-2116) 

UNICOS Environment 
Variables Ready 
Reference (SQ-2117) 

Index for CRAY-2 Man 
Pages (SR-2048) 

Index for CRAY Y-MP, 
CRAY X-M PEA, and 
CRAY X-MP Man Pages 
(SR-2049) 



General (continued) 

Docview Guide 
(SG-2109)* 

Visual Interfaces Guide 
(SG-3094)* 

Tape Subsystem Guide 
(SG-2051)* 

TCP/IP and OSI Network 
Guide (SG-2009)* 

NQS Guide (SG-2105)* 

Security (MLS) Guide 
(SG-2111) 

Kerberos User's Guide 
(SG-2409) 



Text Editing 

Text Editors Primer 
(SG-2050) 

vi Reference Card 
(SQ-2054) 

ed Reference Card 
(SQ-2055) 



MVS Link 

SUPERLINK General 
Information Manual 
(SI-0194) 

SUPERLINK Messages 
(SI-0176) 

SUPERLINK User's 
Guide (SI-0195) 

MVS Station Messages 
(SI-O108) 

Station Reference 
(SI-2066) 

Station Ready Reference 
(SI-0104) 



RQS User's Guide 
(SG-2405) 

NOS/VE Link 

NOSA/E Reference 
(SC-0270) 

UNIX Link 

RQS User's Guide 
(SG-2119) 

CLS-UX User's Guide 
(SU-8121) 



VAX/VMS Link 



— 

VM Link 



SUPERLINK User's Guide 
(SV-3153) 

RQS User's Guide 
(SV-3151) 

Station Primer (SV-0361) 

Station Reference 
(SV-O020) 

Station Ready Reference 
(SV-0102) 



RQS VM User's 
Guide (SI-O170) 

Station Primer (SI-0 167) 

Station Reference 
(SI-0168) 

Station Messages and 
Codes (SI-0 165) 

Station Reference 
Summary (SI-0169) 



* Available on-line with Docview 

§ Man pages available with the man command 
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APPLICATION AND SYSTEM PROGRAMMERS 



Cray Standard C 
Reference (SR-2074)* 

Cray Standard C Ready 
Reference (SQ-2076) 

Ada 

Cray Ada Reference 
(SR-3014) 

Cray Ada Programming 
Guide (SR-3082) 

Pascal 

Pascal Reference 
(SR-O060)* 



Fortran 77 

CF77 Fortran Reference 
(SR^3071)* 

CF77 Compiler Message 
Manual (SR-3072) 

CF77 Vectorization 
Guide (SG-3073)* 

CF77 Parallel Processing 
Guide (SG-3074)* 

CF77 Ready Reference 
(SQ-3070) 



t 



UNICOS Libraries 

System Calls (SR-2012) § 

Fortran Library 
(SR-2079) § 

C Library (SR-2080) § 

Math & Scientific Library 
(SR-2081) § 

Specialized Libraries 
(SR-2057) § 

I/O User's Guide 
(SG^3075)* 

Advanced I/O Guide 
(SG-3076)* 



Loaders 

Loader Reference 
(SR-0066)* 

SEGLDR Reference Card 
(SQ-0303) 

Performance 
Utilities 

Performance Utilities 
Reference (SR-2040)* 

Debuggers 

CDBX Debugger 
Reference (SR-2091)* 

CDBX Debugger User's 
Guide (SG-2094) 



Cray Assembly 
Language (CAL) 

CAL Reference (SR-2003) 

CAL for CRAY Y-MP 
and CRAY Y-MP C90 

Reference (SR-3108) 

Symbolic Machine 
Instructions (SR-3109) 

Ready Reference 
(SQ-3110) 
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T CAL for CRAY X-MP 



and CRAY X-MP EA 

Macros and Opdefs 
Reference (SR-0012) 

Symbolic Machine 
Instructions (SR-0085) 

Ready Reference 
(SQ-0083) 

CAL for CRAY-2 

CAL Ready Reference 
(SQ-2002) 

Macros and Opdefs 
Reference (SR-2082) § 



JT 



Linking Software 

SUPERLINKMVS AAC 
Reference (SI-0197) 

VAXA/MS Station 
Common Access 
Facilities (SN-0362) 

SUPERLINK 
Programmer's Guide 
VAX/VMS (SV-3155) 

Source Control 

USM User's Guide 
(SG-2097)* 

Networking 

RPC Reference (SR-2089) 



Visualization 

UNICOS X Window 
System Reference 
(SR-2101)* 

Other 

Support Tools Guide 
(SG-2016)* 

UNICOS Message 
System Programmer's 
Guide (SG-2121)* 

Compiler Information 
File (CIF) Reference 
(SM-2401) 



SYSTEM ADMINISTRATORS 



General 

UNICOS Installation 
Guide (SG-21 12) 

UNICOS System 
Administration 
(SG-21 13)* 

Administrator Commands 
Reference (SR-2022) § 

Defining and Compiling 
Terminal Definitions 
(SN-2067) 

Docview Writer's Guide 
(SG-21 18)* 

C2 Functionality on MLS 
Systems (SN^4J)7) 



IOS Models B - D 

IOS Guide (SG-0307) 
IOS Messages (SR-2240) 

MVS Link 

Station Installation 
(SI-0078) 

SUPERLINKMVS 
Installation, Tuning, & 
Customization 
(SI-0188) 

RQS Administrator's 
Guide (SG-2406) 



VM Link 

Station Installation & 
Maintenance (S 1-01 62) 

SUPERLINK 
Administrator's Guide 
(SI-0171) 

VAX/VMS Link 

Station Installation 
(SV-O100) 

Station Administration 
(SV-0363) 

RQS Administrator's 
Guide (SV-31 52) 



SUPERLINK Installation 
(SG-5091) 

SUPERLINK 
Administrator's Guide 
(SV-31 54) 

UNIX Link 

RQS Administrator's 
Guide (SG-2120) 

CLS-UX Installation & 
Configuration (SU-3123) 

NOS/VE Link 

NOS/VE Operator 
and Administrator Guide 
(SC-0271) 



* Available on-line with Docview 

§ Man pages available with the man command 
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_ SYSTEM ANALYSTS 



General 

File Formats and Special 
Files Reference 
(SR-2014) § 

Data Migration MSP 
Writer's Guide 
(SN-2098)* 

UNICOS Tuning Guide 
(SR-2099) 

System-specific 
Differences in the User 
Interface (SN-2104) 



Installation Menu System 
Internals (SN-3090) 

CSIM 

User's Guide (SG-2059) 

Ready Reference 
(SQ-2031) 

IOS Models B - D 

Table Descriptions 
(SM-0007) 

Internal Reference 
(SM-0046) 



USCP 

Front-end Protocol 
Internals (SM-0042)* 

USCP Optimization 
(SN-2103) 



_ OPERATORS 



Peripheral 
Expander 

IOS Operator's Guide 
(SG-2005) 

OWS-E 

OWS-E Reference 
(SR-3077) § 

OWS-E Operator's Guide 
(SG-3078) 

OWS-E Administrator's 
Guide (SG-3079) 



ows 

OWS Reference 
(SR-3030) § 

OWS Operator's Guide 
(SG-3042) 

OWS Administrator's 
Guide (SG-3038) 

Linking Software 

CLS-UX(SU-3122) 

SUPERLINK MVS 
(SI-0196) 

MVS Station (SI-0037) 



* Available on-line with Docview 

§ Man pages available with the man command 



New Features 

OWS-E Operator Workstation Reference Manual 
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This rewrite of the OWS-E Operator Workstation Reference Manual supports the 2.0 release of 
OWS-E. The changes include the following: 

• The following man pages are new: 

- conf igf ile(5) and lapf ile(5) describe the OWS-E default configuration file and 
line-arbitration priority file 

- owse_overview(7) provides an overview of the OWS-E commands 

- conv(8) describes the command that converts a file from old edump file format to new 
edump file format 

- craymon(8) describes the command that monitors the mainframe status and sets the 
OWS-E screen background color 

- dumpsy s(8) describes the command that takes a dump image of UNICOS 

- eping(8) describes the command that sends an echo packet to an IOP from the OWS-E 

- lapdaemon(8) describes the command that validates CRI tty lines for users 

- fyadmin(8), fyf ormat(8), and fyroute(8) describe the commands that control the fy 
driver, format the raw trace buffer information extracted from it, and set/display the 
driver's IP Interface Routing table 

- snmpget(l), snmpgetnxt(l), snmpnetstat(l), snmpstatus(l), snmptest(l), 
snmptrap(l), snmptrapd(l), snmpwalk(l), and snmproute(8) describe the various 
commands used with Simple Network Management Protocol (SNMP) 

• The following pages have significant changes: 

- ecrash(8) has been updated to present a more uniform user interface and incorporate 
some features (variables and conditional execution) of a high-level language 

- zip(8) has been changed to apply to the fy driver 

- eboot(8), ediag(8), edump(8), and ehalt(8) all allow you to specify multiple clusters and 
IOPs in one command line 

• The -z option has been eliminated, except for the f yadmin(8) command 

• The following man pages have been deleted: conf ig(3), peek_cpu(3), peek_iop(3), cy(4), 
cz(4), boot al 1(8), booteiop(8), bootios(8), bootmux(8), cztool(8), echopkt(8), 
resetscreen(8), scyadmin(8), scytest(8), sysdump(8), systart(8), and ucon(8). 



RECORD OF REVISION ( 1 ) 



RECORD OF REVISION ( 1 ) 



VERSION DESCRIPTION 

1.0 April 1991. Original printing. 

1 . 1 September 1 99 1 . Reprint with revision to include OWS-E release 1 . 1 changes. 

2.0 May 1992. Reprint with revision to include OWS-E release 2.0 changes. These include 

the new dumpsys(8) command and changes to the options of several commands 
because of the incorporation of the f y driver. 
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This preface describes the scope of this manual and its audience, provides an overview of the 
interrelationships among some of the OWS-E scripts and commands, and lists conventions used in this 
manual, sources of more information, and ways you can send comments about this manual to Cray 
Research, Inc. (CRI). 

ASSUMPTIONS 

This guide was written for administrators of the OWS-E operator workstation. Readers should have at least 
16 hours of training in either the UNICOS or the UNIX operating system; if you have no experience with 
UNICOS or UNIX, you should complete the CRI UNICOS Command Language (UCL-1) course. 

It is assumed that you are running UNICOS operating system release 6.0 or later. 
CONVENTIONS 

The following typographic conventions are used throughout this manual: 
Convention Description 

[ ] Brackets enclose optional elements in syntax lines. 

typewriter font Typewriter font denotes literal items such as command names, file 

names, routines, directory names, path names, signals, messages, and 
programming language structures. 

italic font Italic font denotes variable entries and words or concepts being 

defined. 

bold typewriter font In examples of interactive sessions, bold typewriter font denotes 

literal items entered by the user. Output is shown in nonbold 
typewriter font. 

In this publication, Cray Research, CRI, and Cray refer to Cray Research, Inc. and/or its products. 
CRAY Y-MP always refers to a CRAY Y-MP mainframe with an I/O subsystem model E (IOS-E). 

Most arguments require a leading 0 to specify octal interpretation (for example, 030). For arguments that 
assume octal, a leading 0 will not cause an error. Therefore, it is good practice to specify a leading 0 
whenever you want octal interpretation. 

The entries in this manual are based on a common format. The following list shows the order of sections in 
an entry and describes each section. Most entries contain only a subset of these sections. 

NAME Specifies the name of the entry and briefly states its function. 

SYNOPSIS Presents the syntax of the entry. The following conventions are used in this section: 

Brackets [ ] enclosing a command-line parameter indicate that the parameter is optional. 
When an argument or operand is shown as name or file, it always refers to a file name. 

Ellipses . . . indicate that the preceding command-line parameter may be repeated. 

A parameter beginning with a minus, plus, or equal sign (-, +, or =) is usually an option. 

DESCRIPTION Discusses the entry in detail. 

NOTES Points out items of particular importance. 

CAUTIONS Describes actions that can destroy data or produce undesired results. 
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WARNINGS Describes actions that can harm people, equipment, or system software. 

CONFIGURATION FILE PARAMETERS 

Describes parameters from the OWS-E configuration file (by default, 
/etc/ con f ig f i 1 e) that are read by the command in question. 

BUILT-IN COMMANDS 

Describes subcommands that may be invoked from within a command. 

ENVIRONMENT VARIABLES 

Describes predefined shell variables that determine some of the characteristics of the 
shell or that affect the behavior of some programs, commands, or utilities. 



RETURN VALUE Describes possible error returns. 



MESSAGES Describes the informational, diagnostic, and error messages that may appear. Self- 
explanatory messages are not listed. 



BUGS Indicates known bugs and deficiencies. 

EXAMPLES Shows examples of usage. 

FILES Lists files that are either part of the entry or related to it. 



SEE ALSO Lists entries that contain related information and specifies the manual in which each 
entry appears. 



MAN PAGE REFERENCES 

Throughout this document, reference is made to the on-line man pages available through the man 
command. A man page is a discussion of a particular element of software. 

Each man page includes a general description of one or more commands, routines, or other topics and 
provides details of their usage (command syntax, routine parameters, system call arguments, and so on). If 
more than one topic appears on a page, the entry will appear in the printed manual alphabetized only under 
its major name. You can access a man page named Is on-line by typing man Is. 

Printed versions of the man pages are published in OWS-E Operator Workstation Reference Manual, 
publication SR-3077. Man pages are grouped into sections numbered. Each section contains entries of a 
particular type. Types of entries include user commands, administrator commands, and file formats. 

The following table lists the type of entry associated with each section number shown and the manual in 
which the section is published. 

Section Subject and Publication 

1 SunOS user commands, found in SunOS Reference Manual (Vol. I) 

UNICOS User commands, found in UNICOS User Commands Reference Manual, 
publication SR-2011 

Simple Network Management Protocol (SNMP) user commands, found in OWS-E Operator 
Workstation Reference Manual, publication SR-3077 

5 OWS-E file formats, found in OWS-E Operator Workstation Reference Manual, publication 

SR-3077 

7 OWS-E topics, found in OWS-E Operator Workstation Reference Manual, publication SR-3077 
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8 OWS-E administrator commands, found in OWS-E Operator Workstation Reference Manual, 

publication SR-3077 

SunOS administrator commands, found in SunOS Reference Manual (Vol. Ill) 

UNICOS administrator commands, found in UNICOS Administrator Commands Reference 
Manual, publication SR-2022 

Section numbers appear in parentheses after man page names. Man pages are referenced in text by entry 
name and section number, as shown in the following example: 

To take a system dump, enter the dumpsy s(8) command in an OWS-E window. 



FOR MORE INFORMATION 

The following are related publications, listed by topic; assume that a manual is a CRI publication unless it is 
otherwise identified. 



Topic 

Operator training 



OWS-E commands 



Sources of Information 

UNICOS Operator Training (TR-UOT) 

UNICOS Command Language (TR-UCL-1) 

Cray Research Software Training Catalog for Customers 

(TR-CUSTCAT) 



OWS-E installation 
SunOS user information 



OWS-E Operator Workstation Reference Manual (SR-3077) 
OWS-E Operator Workstation Ready Reference (SQ-3080) 

OWS-E 2.0 Release and Installation Notes (RN-5060) 

SunOS 4.1 User's Guides, order number 851-1028-01 (Sun 
Microsystems Inc.); also available on-line through Answerbook. 
SunOS Reference Manual (Vol. I), order number 825-1244-01 (Sun 
Microsystems, Inc.) 

Using Answerbook, order number 800-6908-10 (Sun 
Microsystems, Inc.) 

SunOS system administrator information 

System and Network Administration (Vol. II and III), order number 
800-3805-10 (Sun Microsystems Inc.); also available on-line through 
Answerbook. 

SunOS Reference Manual (Vols. II and III), order number 
825-1244-01 (Sun Microsystems Inc.) 

OpenWindows Sun OpenWindows Version 3 End User's Manuals, order number 

851-1035-01 (Sun Microsystems Inc.); also available on-line through 
Answerbook. 

UNICOS user information UNICOS User Commands Reference Manual (SR-201 1) 

UNICOS User Commands Ready Reference (SQ-2056) 
UNICOS Message Reference Manual (SR-2200) 

UNICOS administrator information UNICOS System Administration (SG-21 13) 

UNICOS Administrator Commands Reference Manual (SR-2022) 

IOS-E administration I/O Subsystem Model E (IOS-E) Guide, (SD-2107). This document is 

CRAY RESEARCH PRIVATE. It can be distributed to non-CRI 
personnel only with approval of the appropriate Cray manager. 

For a more detailed list of Sun Microsystem's, Inc., documentation, see the OWS-E Release and Installation 
Notes. 
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ORDERING PUBLICATIONS 

The User Publications Catalog, publication CP-0099, lists all Cray Research hardware and software 
manuals that are available to customers. 

To order a manual, either call the Distribution Center in Mendota Heights, Minnesota, at (612) 681-5907 
or send a facsimile of your request to fax number (612) 681-5920. Cray Research employees may choose 
to send electronic mail to order . desk (UNDCsystem users) or order desk (HPDesk users). 

READER COMMENTS 

If you have comments about the technical accuracy, content, or organization of this manual, please tell us. 
You can contact us in any of the following ways: 

• Send us electronic mail from a UNICOS or UNIX system, using the following UUCP address: 

uunet ! cray 1 publications 

• Send us electronic mail from any system connected to Internet, using one of the following Internet 
addresses: 

pubs 3 0 7 7 @ t imbuk . cray . com (comments specific to this manual) 
publ i cat ions @ t imbuk . cray . com (general comments) 

• Contact your Cray Research representative and ask that a Software Problem Report (SPR) be filed. 
Use publications for the group name, PUBS for the command, and no-license for the 
release name. 

• Call our Software Information Services department in Eagan, Minnesota, through the North 
American Support Center, using either of the following numbers: 

(800) 950-2729 (toll free from the United States and Canada) 

(612) 683-5600 

• Send a facsimile of your comments to me attention of "Software Information Services" in Eagan, 
Minnesota, at fax number (612) 683-5599. 

• Use the postage-paid Reader's Comment form at the back of this manual. 
We value your comments and will respond to them promptly. 
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more specified IOPs 61 

edump Dumps IOS-E IOP local memory images to the OWS-E 64 

ehalt Halts one or more IOPs from the OWS-E 68 

emon Restarts the IOS-E error-logging, heartbeat, SMARTE, and CPU 

monitors 70 

eping Sends an echo packet to an IOP from the OWS-E 71 

errlogd IOS-E hardware error-logging daemon 73 
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IOS-E 97 
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mfstart Starts the mainframe CPUs from the OWS-E 103 
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ones 105 
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daemon) Ill 

smdemon Monitors the OWS-E system for SMARTE 1 12 

smdstop Terminates the SMARTE OWS-E system monitor daemon 113 

snmproute r Performs route tracing with the Simple Network Management Protocol 1 14 

xsnmpmon Invokes the SNMP network monitor 1 15 

zip Acts as the terminal interface to a running CPU 127 
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NAME 

snmpget - Communicates with a network entity by using SNMP GET requests 
SYNOPSIS 

snmpget [-d] host community variable-name [variable-name] . . . 
DESCRIPTION 

The snmpget command is an SNMP application that uses the GET request to query for information on a 
network entity. You can specify one or more fully qualified object identifiers as arguments on the 
command line. 

The snmpget command accepts the following arguments: 

-d Directs the application to dump input and output packets. 

host Specifies either a host name or an Internet address in dot notation. 

community Specifies the community name for the transaction with the remote system. 

variable-name 

Specifies the fully qualified object identifier to be retrieved by the snmpget request. 

EXAMPLES 

The following command retrieves the sysDescr . 0 and sysUpTime . 0 variables: 

I snmpget dang.cray.com criccn mgmt .mib-2 . system. sysDescr . 0 \ 

mgmt .mib-2 . system. sysUpTime . 0 

The output is as follows: 

Name : mgmt .mib-2 . system. sysDescr . 0 

OCTET STRING- (ascii) : Kinetics FastPath2 

Name : mgmt .mib-2 . system. sysUpTime . 0 
Timeticks: (2270351) 6:18:23 

If the network entity encounters an error while processing the request packet, an error packet is returned and a 
message is shown, which helps to determine the error in the request. If other variables were in the request, the 
request is resent without the bad variable. 

SEE ALSO 

RFC 1 155, RFC 1 156, RFC 1157 
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NAME 

snmpgetnxt - Communicates with a network entity by using SNMP GET NEXT requests 
SYNOPSIS 

snmpgetnxt [-d] host community variable-name [variable-name] . . . 
DESCRIPTION 

The snmpgetnxt command is an SNMP application that uses the GET NEXT request to query for 
information on a network entity. You can specify one or more object identifiers as arguments on the 
command line. For each one, the variable that is lexicographically "next" in the remote entity's 
Management Information Base (MIB) is returned. 

The snmpgetnxt command accepts the following arguments: 

-d Directs the application to dump input and output packets. 

host Specifies either a host name or an Internet address in dot notation. 

community Specifies the community name for the transaction with the remote system. 

variable-name 

Specifies the fully qualified object identifier to be retrieved by the snmpgetnxt request. 

EXAMPLES 

The following command retrieves the sysDescr . 0 and sysUpTime . 0 variables: 

snmpgetnxt dang.cray.com criccn mgmt .mib-2 . system. sysDescr . 0 \ 
mgmt .mib-2 . system. sysUpTime . 0 

The output is as follows: 

Name : mgmt .mib-2 . system. sysObj ect ID. 0 

OBJECT IDENTIFIER: . iso . org . dod . internet . private . enterprises . 3 4 

Name : mgmt .mib-2 . system. sysContact . 0 

OCTET STRING- (ascii) : John Doe doe@cray.com 

If the network entity encounters an error while processing the request packet, an error message is shown, 
which helps to determine the error in the request. 

SEE ALSO 

RFC 1155, RFC 1156, RFC 1157 
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NAME 

snmpnetstat - Shows network status by using SNMP 

SYNOPSIS 

snmpnetstat host community 

snmpnetstat host community [-an] 

snmpnetstat host community [-inrs] 

snmpnetstat host community [-n] [-1 interface] interval 

snmpnetstat host community [-p protocol] 

DESCRIPTION 

The snmpnetstat command symbolically displays the values of various network-related information 
retrieved from a remote system by using the SNMP protocol. There are several output formats, depending 
on the options for the information presented. The first form of the command displays a list of active 
sockets. The second form presents the values of other network-related information according to the option 
selected. Using the third form, with an interval specified, snmpnetstat continuously displays the 
information about packet traffic on the configured network interfaces. The fourth form displays statistics 
about the specified protocol. 

The snmpnetstat command accepts the following arguments: 

host Specifies either a host name or an Internet address in dot notation. 

community Specifies the community name for the transaction with the remote system. 

-a With the default display, shows the state of all sockets; usually sockets used by server 

processes are not shown. 

-n Shows network addresses as numbers (usually snmpnetstat interprets addresses and 

attempts to display them symbolically). You can use this option with any of the display 
formats. 

- i Shows the state of all interfaces. 

-r Shows the routing tables. When -s is also present, shows routing statistics instead, 

-s Shows per-protocol statistics. 

- 1 interface Shows information about only the specified interface; used with the interval argument. 

interval Specifies interval (in seconds) through which packet traffic information is displayed. 

-p protocol Shows statistics about protocol, which is either a well-known name for a protocol or an alias 
for it. Some protocol names and aliases are listed in the /etc/protocols file. A null 
response typically means that there are no interesting numbers to report. The program 
complains if protocol is unknown or if no statistics routine for it exists. 

For active sockets, the default display shows the local and remote addresses, protocol, and internal state of 
the protocol. If a socket's address specifies a network but no specific host address, address formats are of 
the form host . port or network . port. When known, the host and network addresses are displayed 
symbolically according to the /etc/hosts and /etc/networks databases, respectively. If a 
symbolic name for an address is unknown, or if the -n option is specified, the address is printed 
numerically, according to the address family. For more information about the Internet dot format, see 
inet(3). Unspecified or wildcard addresses and ports appear as *. 

The interface display provides a table of cumulative statistics about packets transferred, errors, and 
collisions. The network addresses of the interface and the maximum transmission unit (MTU) are also 
displayed. 
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The routing table display indicates the available routes and their status. Each route consists of a destination 
host or network and a gateway to use when forwarding packets. The flags field shows the state of the route 
(U if up), whether the route is to a gateway (G), whether the route was created dynamically by a redirect 
(D), and whether the route was modified by a redirect (M). Direct routes are created for each interface 
attached to the local host; the gateway field for such entries shows the address of the outgoing interface. 
The interface entry indicates the network interface used for the route. 

When you invoke snmpnet stat with an interval argument, it displays a running count of statistics 
related to network interfaces. This display consists of a column for the primary interface and a column 
summarizing information for all interfaces. Use the- 1 option to replace the primary interface with another 
interface. The first line of each screen of information contains a summary since the system was last 
rebooted. Subsequent lines of output show values accumulated over the preceding interval. 

EXAMPLES 

The following snmpnet stat commands produce network statistics: 



snql-% snmpnetstat localhost criccn -i 



Name 


Mtu 


Network 


Address 


Ipkts Ierrs 


Opkts Oerrs 


hyO* 


16432 


none 


none 


0 


0 


0 


0 


hyl 


16432 


none 


none 


112544 


0 


87800 


0 


vmeO* 


16432 


none 


none 


0 


0 


0 


0 


vmel* 


16432 


none 


none 


0 


0 


0 


0 


lsxO* 


16432 


none 


none 


0 


0 


0 


0 


hiO* 


65528 


none 


none 


0 


0 


0 


0 


hil* 


65528 


none 


none 


0 


0 


0 


0 


unetO* 


32880 


none 


none 


0 


0 


0 


0 


loO 


65535 


none 


none 


49528 


0 


49534 


0 


snql-% 


snmpnetstat localhost criccn -I hyl 










Name 


Mtu 


Network 


Address 


Ipkts 


Ierrs 


Opkts 


Oer: 


hyl 


16432 none 


none 


113178 


0 


88523 





snql-% snmpnetstat localhost criccn 
Active Internet Connections 



Proto 


Recv-Q 


Send-Q 


Local 


. Address 




Foreign Address 


(state) 


tcp 


0 


0 


*.1272 






* * 


CLOSED 


tcp 


0 


0 


localhost . 


. cray 


'.c.1272 


localhost . cray . c . sunrp 


TIMEWAIT 


tcp 


0 


0 


snql . 


cray . 


, com. 


telnet 


berserkly . cray . c . 1518 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


telnet 


cherry28 .cray . co. 193 4 


TIMEWAIT 


tcp 


0 


0 


snql . 


cray . 


. com. 


telnet 


f ir21 .cray.com. 1083 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


telnet 


palml5 . cray . com. 1093 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


telnet 


palml5 . cray . com. 1094 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


, com. 


telnet 


sumacl5 . cray . com. 1256 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


telnet 


sumacl5 . cray . com. 1257 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


telnet 


sumacl5 . cray . com. 1258 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


telnet 


hose . cray . com. 2946 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


login 


palm03 . cray . com. 1021 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


login 


palmlO . cray . com. 1022 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


login 


poplarl7 . cray . co . 102 1 


ESTABLISHED 


tcp 


0 


0 


snql . 


cray . 


. com. 


809 


aspenl8 . cray . com. 980 


TIMEWAIT 


tcp 


0 


0 


snql . 


cray . 


. com. 


815 


cher ry2 8 . cray . co . she 1 1 


TIMEWAIT 
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SEE ALSO 

inet(3) in the Volume 2: UNICOS C Library Reference Manual, publication SR-2080 

hosts(5), networks(5), protocols(5), services(5) in the UNICOS File Formats and Special Files 

Reference Manual, publication SR-2014 

RFC 1157 
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NAME 

snmps tatus - Retrieves important information from a network entity by using SNMP requests 

SYNOPSIS 

snmps tatus [-d] host community 

DESCRIPTION 

The snmps tatus command is an SNMP application that retrieves several important statistics from a 
network entity. 

The snmps tatus command accepts the following arguments: 

-d Directs the application to dump input and output packets. 

host Specifies either a host name or an Internet address in dot notation. 

community Specifies the community name for the transaction with the remote system. If you do not 
specify this argument, the community name defaults to public. 

The information returned is as follows: 

• The IP address of the entity. 

• A textual description of the entity (sysDescr . 0). 

• The up time of the entity (sysUpTime . 0). 

• The sum of received packets on all interfaces (if InUCastPkts . * + if inNUCastPkts . *). 

• The sum of transmitted packets on all interfaces (i f OutUCas t Pkt s . * + 
ifOutNUCastPkts . *). 

• The number of IP input packets (ipInReceives . 0). 

• The number of IP output packets (ipOutRequests . 0). 

EXAMPLES 

The following snmpstatus command produces statistical information: 

snmps tatus netdev-kbox.cc.cmu.edu public 

The output is as follows: 

[128.2.56.220]=>[Kinetics FastPath2] Up: 1 day, 4:43:31 
IP recv/trans packets 262874/39867 | 
IP recv/trans packets 31603/15805 

Thesnmpstatus command also checks the operational status of all interf aces (ifOperStatus . *);ifit 
finds any that are not running, it reports the interfaces as in the following example: 

2 interfaces are down 1 

If the network entity encounters an error while processing the request packet, an error packet is returned and a 
message is shown, which helps to determine the error in the request, s nmp status attempts to reform its 
request to eliminate the malformed variable, but this variable will then be missing from the displayed data. 

SEE ALSO 

RFC 1155, RFC 1156, RFC 1157 
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NAME 

snmptest - Communicates with a network entity by using SNMP requests 

SYNOPSIS 

snmptest [-d] host community 

DESCRIPTION 

The snmptest command is a flexible SNMP application that can monitor and manage information on a 
network entity. 

The snmptest command accepts the following arguments: 

-d Directs the application to dump input and output packets. 

host Specifies either a host name or an Internet address in dot notation. 

community Specifies the community name for the transaction with the remote system. 

After invoking the program, a command-line interpreter begins to accept commands. It prompts with the 
following request: 

Please enter the variable name: 

You can enter one or more variable names, one per line. A blank line is a command to send a request for each 
of the variables (in a single packet) to the remote entity. 

EXAMPLES 

In the following snmptest command, the system . sysDescr . 0 name is entered at the prompt: 
snmptest netdev-kbox.cc.cmu.edu public 

Please enter the variable name: mgmt .mib-2 . system. sysDescr . 0 
Please enter the variable name: 

The following information about the request and reply packets is returned: 

Name: system. sysDescr . 0 
OCTET STRING- (ascii) : 

On startup, the program defaults to sending a GET request packet. This can be changed to a GET NEXT request 
or a SET request by entering the $Nor $S command, respectively. Entering $Greturns you to the GET request 
mode. 

The $D command toggles the dumping of each sent and received packet. 

When in SET request mode, more information is requested by the prompt for each variable. The following 
prompt requests that you enter the type of the variable: 

Please enter variable type [i|s|n]: 

Enter i for an integer, s for an octet string, or n for a null value. 
You are then prompted for a value, as follows: 

Please enter new value: 
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If it is an integer value, enter the integer (in decimal). If it is a string, enter decimal numbers separated by white 
space, one per byte of the string. Again, enter a blank line at the prompt for the variable name to send the 
packet. 

Entering $ Q at the prompt quits the program. 

SEE ALSO 

RFC 1 155, RFC 1 156, RFC 1 157 
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NAME 

snmptrap - Sends an SNMP TRAP message to a host 
SYNOPSIS 

snmptrap host community trap-type specific-type device-description [-a agent-addr] [-d] 
DESCRIPTION 

The snmptrap command is an SNMP application that forms and sends an SNMP TRAP message to a host. 

The snmptrap command accepts the following arguments: 

host Specifies either a host name or an Internet address in dot notation. 

community Specifies the community name for the transaction with the remote system. 

trap-type Specifies the type of TRAP message being sent. Trap types are integers defined as follows: 

0 (Cold start) 

The sending protocol entity is reinitializing itself such that the agent's configuration 
or the protocol entity implementation can be altered. 

1 (Warm start) 

The sending protocol entity is reinitializing itself such that neither the agent 
configuration nor the protocol entity implementation is altered. 

2 (Link down) 

The sending protocol entity recognizes a failure in one of the communication links 
represented in the agent's configuration. 

3 (Link up) 

The sending protocol entity recognizes that one of the communication links 
represented in the agent's configuration has come up. 

4 (Authentication failure) 

The sending protocol entity is the addressee of a protocol message that is not 
properly authenticated. While implementations of the SNMP must be able to 
generate this trap, they must also be able to suppress the emission of such traps 
through an implementation-specific mechanism. 

5 (EGP neighbor loss) 

An exterior gateway protocol (EGP) neighbor for whom the sending protocol entity 
was an EGP peer was marked down and the peer relationship no longer remains. 

6 (Enterprise specific) 

The sending protocol entity recognizes that some enterprise-specific event has 
occurred. 

specific-type Identifies the particular trap that occurred. 

device-description 

Provides a textual description of the device sending this trap, which is used as the value of a 
syst em . sysDescr . 0 variable sent in the variable list of this trap message. 

-a agent-addr 

Changes the address from which the trap reports it is being sent; otherwise, the sending 
host's address is used. This argument is optional. 

-d Directs the application to dump the input and output packets. 
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EXAMPLES 

The following snmptrap command sends a cold start trap to the specified machine: 
snmptrap nic.andrew.cmu.edu public 0 0 

SEE ALSO 

RFC 1155, RFC 1156, RFC 1157 
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NAME 

snmptrapd - Receives and logs SNMP TRAP messages 

SYNOPSIS 

snmptrapd [-p] [-d] 

DESCRIPTION 

The snmptrapd command is an SNMP application that receives and logs SNMP TRAP messages sent to 
the SNMP -TRAP port (162) on the local machine. 

The snmptrapd command accepts the following options: 

-p Prints trap messages to the standard output; otherwise, it uses sy s logd(8) to log messages. 

These sy s log messages are sent with the level of L OG_WARN I NG and, if available (usually on 
BSD 4.3 systems), they are sent to the LOG_LOCAL0 facility. 

Following is an example of a log message: 

Sep 17 22:39:52 suffern snmptrapd: 128.2.13.41: Cold Start \ 
Trap (0) Uptime: 8 days, 0:35:46 



- d Directs the application to dump input and output packets. 

The snmpt rapd command must be run as root so that UDP port 162 can be opened. 

LES 

The following is an example of the use of snmptrapd. The snmpd daemon sends the coldstart trap (last 
line of the example) when it is started. 

# snmptrapd -p & 

# sdaemon -k snmpd 
Stopping daemon : snmpd . 

# sdaemon -s snmpd 
Starting daemon: snmpd. 

# 128.162.82.6: Cold Start Trap (0) Uptime: 0:00:00 



SEE ALSO 

syslogd(8) in the UN ICOS Administrator Commands Reference Manual, publication SR-2022 
RFC 1155, RFC 1156, RFC 1157 
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NAME 

snmpwalk, snmpwalka - Communicates with a network entity by using SNMP GET NEXT requests 
SYNOPSIS 

snmpwalk host community [variable -name] [-d] 
snmpwalka host community [variable-name] [-d] 

DESCRIPTION 

The snmpwalk command is an SNMP application that uses GET NEXT requests to query for a tree of 
information about a network entity, snmpwalka performs the same function asynchronously; it does not 
wait for a response from the agent before issuing another request. 

The snmpwalk and snmpwalka commands accept the following arguments: 

host Specifies either a host name or an Internet address in dot notation. 

community Specifies the community name for the transaction with the remote system. 

variable-name 

Specifies the portion of the object identifier space that is searched, using GET NEXT 
requests. All variables in the subtree below the given variable are queried and their values 
presented to the user. 

If the variable-name argument is not present, snmpwalk searches the whole Internet 
Management Information Base (MIB). 

-d Directs the application to dump input and output packets. 

EXAMPLES 

The following example retrieves the rnib-2 system variables: 

snmpwalk netdev-kbox.cc.cmu.edu public mgmt .mib-2 . system 
The output is as follows: 

Name: system. sysDescr . 0 

OCTET STRING- (ascii) : Kinetics FastPath2 
Name: system . sysObj ect ID . 0 

OBJECT IDENTIFIER: . iso . org . dod . internet . private . enterprises . \ 

CMU . sysID . CMU-KIP 

Name: system. sysUpTime . 0 
Timeticks: (2291082) 6:21:50 

If the network entity encounters an error while processing the request packet, an error packet is returned and a 
message is shown, which helps to determine the error in the request. 

If the tree search causes attempts to search beyond the end of the MIB, the following message is displayed: 

End of MIB. 
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SEE ALSO 

RFC 1155, RFC 1156, RFC 1157 
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NAME 



/etc/con figfile - Default OWS-E configuration file 



DESCRIPTION 



The system configuration file, /etc/conf igf ile, contains the system parameter labels and their 
corresponding values used by the OWS-E software. This file is divided into two sections, as follows: 

• Configurable parameters set during the installation process to site-specific values 

• Configurable parameters set at release time 

Many of the parameters contain tokens that are changed during the installation process to reflect the 

specific machine being installed. These tokens are designated by TOKEN (that is, they are preceded 

and followed by underscores). If any of these tokens remain in/etc/con figfile following 
completion of the installation, they should be changed as instructed in OWS-E Operator Workstation 
Administrator's Guide, CRI publication SG-3079. 

The parameters, with brief descriptions, are listed here in alphabetical order; for more details, see OWS-E 
Operator Workstation Administrator's Guide, which lists parameters in the order in which they are found 
in /etc/conf igf ile. 

ADUMPDIR Defines the path name of the directory holding the dump lock file mentioned 

in the descriptions of the cpupanic and IOPHALT parameters. Default: 

/home/ HOSTNAME /cri/bin/adm 



AUTODUMP 



BASEPORT 



BOOTFILE 



CPUD 



CPUD HOSTNAME 



CPUPANIC 



CRAYMON 



Defines the path name of the command that controls automatic dumping of 
the mainframe and the IOS-E. Default: 

/ home / HOSTNAME / cri/bin/ au t odump 

Defines the starting port value used for the various operator interface 
software daemons. Default: 

4370 

Defines the path name of the boot file. Default: 

/var/ logs /boot file 

Defines the path name of the command that gathers data and disperses CPU 
time statistics. Default: 

/home/ HOSTNAME /cri/bin/cpud 

Specifies the name of the machine on which the CPU monitor, cpud(8), is 
running. Default: 

CPUDHOSTNAME token (replaced during installation) 

Defines the path name of the cpupanic(8) script. Default: 

/home/ HOSTNAME /cri/bin/cpupanic 

Defines the colors of the OWS-E that denote whether the mainframe is up 
(first color) or down (second color). The colors must consist of one word 
each, and they must be separated by a comma; spaces cannot appear within 
or between the two colors. Default: 

SkyBlue, red 
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DOFWA 
DOLWA 
D1FWA 
D1LWA 
D2FWA 
D2LWA 
D3FWA 

D3LWA 



DEF MFCHAN 



DEFAULTIDUMPDIR 



DEFAULTIKERNDIR 



DEFAULTIOP 



DEF AULTUKERNF I LE 



DEFAULTUPARAMF ILE 



DIOPATH 



DLEN 



DSTART 



DTYPE 



DUMP 



These parameters define the actual mainframe memory ranges to be 
dumped. Default: 

At release, only the first range is specified, and the other ranges are 
set to 0. This first range is set to start at word address 0 and end at 
word address 020000000. 

Defines the mainframe channel number of the low-speed channel attached 
to the cluster that deadstarts the mainframe. Default: 

020 

Defines the default dump directory path in which the dump shell script is 
created. Default: 

/var/dumps 

Defines the path name to the directory in which all of the IOS-E binary files 
are kept. Default: 

/home/ HOSTNAME /cri/os/ios 

Defines the default IOP through which the IOS-E is booted. Default: 

0 

Defines the path name to the default UNICOS binary file. Default: 

/home/ HOSTNAME /cri/os/uts/unicos 

Defines the path name to the default UNICOS parameter file. Default: 

/home/ HOSTNAME /cri/os/uts/param 

Defines the path that the memory dump will take from the mainframe to the 
disk. Default: 

DUMP IO token (replaced during installation) 

Defines the length, in sectors, of the disk slice to which the memory will be 
dumped. Default: 

DUMPLEN token (replaced during installation) 

Defines the starting sector of the disk slice to which the memory will be 
dumped. Default: 

DSTARTBL token (replaced during installation) 

Defines the type of the disk to which the mainframe memory will be 
dumped. Default: 

DUMPTYPE token (replaced during installation) 

Defines the name of the dump lock file mentioned in the descriptions of the 
ADUMPDIR, CPUPANIC, and I OPHALT parameters. Default: 

dump . on 
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DUNIT 



EBOOT 



ECON 



ED I AG 



ERRLOG 



ERRLOGD 



HBEAT 



HCON 



IOP DIAGNOSTICS 



IOPDEBUG 



IOPHALT 



IOPLOG 



I OPS AVE 



IOSCPATH 



IOSDPATH 



Defines the default dump device unit that the mf dump(8) command uses 
when routing the mf sysdmp binary file to the mainframe before the dump. 
Default: 

DUMPUNIT (replaced during installation) 

Defines the path name of the command that boots an IOP from the OWS-E. 
Default: 

/home/ HOSTNAME /cri/bin/eboot 

Defines the path name of the command that configures a MUXlOP-to-ElOP 
low-speed channel up or down. Default: 

/home/ HOSTNAME /cri/bin/econ 

Defines the path name of the command that boots deadstart diagnostic tests 
into a specified IOP. Default: 

/home/ HOSTNAME /cri/smarte/bin/ediag 

Defines the path name of the error log file. Default: 

/var/ logs /err log 
Defines the path name of the error logging daemon. Default: 

/home/ HOSTNAME /cri /bin/err logd 

Defines the path name of the IOP monitor. Default: 

/home/ HOSTNAME /cri/bin/hbeat 

Defines the path name of the command that configures a MUXIOP high- 
speed channel up or down. Default: 

/home/ HOSTNAME /cri/bin/hcon 

Controls whether diagnostic tests are run by bootsys(8) before booting 
the IOS-E. Valid values are on, off, and only. Default: 

on 

Defines the path name of a temporary file that the ecrash(8) utility uses 
during its processing. Default: 

/home/ HOSTNAME /cri/os / ios / iopdebug 

Defines the path name of the iophalt script. Default: 

/home/ HOSTNAME /cri /bin/ iophalt 

Defines the path name of the IOP log file. Default: 

/var/ logs/ ioplog 

Defines the path name of a temporary file used by the edump(8) utility 
during its processing. Default: 

/home/ HOSTNAME /cri/os / ios / iopsave 

Defines the path name of the I/O clear diagnostic test. Default: 

/home/ HOSTNAME /cr i/os/ ios /clear io 

Defines the path name of the IOP deadstart diagnostic test. Default: 

/home/ HOSTNAME /cri/os/ ios /dsdiag 
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LAPFILE 



M MEMORY 



MAIL CPUFAIL 



Specifies the location of the line-arbitration priority file used by 
lapdaemon(8). Default: 

/etc/lapf ile 

Defines the memory size of the mainframe to which the OWS-E is attached. 
Default: 

MEMORY token (replaced during installation) 

Defines the login name to which mail is sent if a CPU panics. Default: 



MAIL IOPFAIL 



Defines the login name to which mail is sent if an IOP halts. Default: 



MAINFRAME 



MFBOOT 



MFINIT 



MFIPATH 



MF START 



MFSYSDMP 



MOTDPATH 



RCPUD 



ROOTDIR 



SERIALNUMBER 



Defines the type of mainframe to which the OWS-E is attached. Default: 

MAINFRAME token (replaced during installation) 

Defines the path name of the bootstrap loader program used by the 
mf dump(8) command. Default: 

/home / HOSTNAME / cr i /os/uts /mf boo t 

Defines the path name of the command that runs a mainframe and IOS-E 
initialization and confidence test. Default: 

/home/ HOSTNAME /cri/bin/mf init 

Defines the path name of the diagnostic program used by the mf in it (8) 
command. Default: 

/home/ HOSTNAME /cri/os/uts/mf chkye 

Defines the path name of the command that starts the mainframe CPU from 
the OWS-E. Default: 

/home/ HOSTNAME /cri/bin/mf start 

Defines the path name of the CPU-resident program used by the mf dump(8) 
command. Default: 

/home/ HOSTNAME /cri/os/uts/mf sysdmp 

Specifies the path name of a text file that is displayed by the bootsys(8) 
comand prior to booting a system. For example, this file might be used to 
convey information about system reconfiguration. If this parameter is not 
defined or is commented out, no message is displayed. The file must be 
readable by the group cri. A commented-out example is given in 
/etc/conf igf ile. 

Defines the path name of the remote CPU request daemon. Default: 

/home/ HOSTNAME /cri/bin/rcpud 

Defines the base directory used by scripts to find the CRI commands that 
they execute during processing. Default: 

/home/ HOSTNAME /cri 

Defines the serial number of the CRI mainframe to which the OWS-E is 
attached. Default: 

SERIALNUMBER token (replaced during installation) 
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SMDEMON 



SSD MEMORY 



SSTBACKUP 



UPDATESECS 



Defines the path name of the daemon that monitors the OWS-E for SMARTE. 
Default: 

/home/ HOSTNAME /cri/ smart e/bin/smdemon 

Defines the memory size of the SSD attached to the mainframe to which the 
OWS-E is attached. Default: 

SSD_MEMORY token (replaced during installation) 

Specifies the back-up hbeat(8) status table. Default: 

/var/logs/sstbackup 
Defines (in seconds) the polling rate for the passive CPU monitors. Default: 

5 



FILES 



/usr/openwin/lib/rgb. txt 
SEE ALSO 



Default colors file 



getconf ig(8) for information about retrieving system parameter values from the system configuration 
file 

OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for more information about 

/ etc/conf igf ile 
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NAME 

/etc/1 ap file - Default line arbitration priority file 
DESCRIPTION 

The lapf ile line arbitration priority file is used by the lapdaemon(8) program to determine the priority 
of users. The location of this file is specified by the LAPF ILE ("line-arbitration priority file") parameter 
in /etc/conf igf ile; by default, LAPFILE is set to /etc/lapf ile. 

Users not listed in /etc/lap file have a default priority of 0; that is, they have no priority and cannot 
usurp a tty line. You can specify a priority higher than 0 for particular users by including their priority 
numbers and login IDs in /etc/ lapf ile, as follows: 

prioritynumber login[, login...] 

The priority number must be separated from the login ID by white space, such as a tab or space. You can 
include comments in the file by beginning them with apound sign (#); blank lines are ignored. You can 
specify a single priority level for multiple users by placing their logins on one line, separating the logins with 
commas as in the following example: 

5 john, mary, louise 

Logins used in / etc/1 ap file must begin with an alphabetic character. The priority number can be any 
positive integer; the higher the number, the higher the priority. (Negative numbers are not allowed.) 

To activate changes to/etc/lapfile, you must send the lapdaemon(8) program a HUP (hang up) signal. 
To do this, find the process identification (PID) number of lapdaemon with the SunOS ps(l) command and 
then terminate the PID with the following command line (where Ipid is the lapdaemon PID number): 

owsl60 0% kill -HUP Ipid 

EXAMPLES 

Suppose you wanted chr is and terry to have a priority greater than pat but less than cri. Your 
/etc/1 ap file file might contain the following: 

# /etc/lapfile PRIORITY FILE 

# Logins not listed have a default priority 

# of 0. 

1 root 

3 pat #pat should be lower than chris 

4 chris, terry 
20 cri 
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FILES 

/etc/configfile Default configuration file 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/configfile 

lapdaemon(8) for information about the line arbitration priority daemon 

z ip(8) for information about the command that supplies the terminal interface to a running CPU 
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NAME 

/etc/owsepermf ile - Default OWS-E permissions file 
DESCRIPTION 

The owsepermf ile permissions file lists those who can access the following OWS-E commands: 



autodump 


ehalt 


mf dump 


bootsys 


emon 


mf init 


cpuhalt 


eping 


mf start 


craymon 


errlogd 


peek 


eboot 


estat 


poke 


econ 


dumpsys 


rcpud 


ecrash 


hbeat 


zip 


edump 


hcon 





When a user logs in, the va 1 i d_u s e r library routine examines the access list in/etc/owsepermfileto 
determine which commands the user may execute. If the user tries to execute a command for which he or she 
does not have access, the following error message is issued: 

ERROR: progname : User username not validated for use 

The / etc / owseperm file file must contain an entry for every account that wants to access these 
commands. The user ID must be the first item on a line, followed by the commands and scripts that the user is 
allowed to access. You can use space, tabs, or a colon to separate the user ID from the list, and you can separate 
items within the list by using spaces, tabs, or commas. An asterisk ( * ) indicates that the user is permitted to 
access all commands and scripts. If you want to include comments, precede them by using the pound sign (#). 

When you assign permission, you must be aware of the hierarchy of commands; that is, you must know which 
commands call other commands. 

NOTES 

All users included in /etc/owsepermf ile must also be included in the password file. If a specified 
user is not in the password file, errors will result. 

EXAMPLES 

The following is an example of an access list in /etc/owsepermf ile: 

bgj mf start , edump, eboot 

swj :mf start , edump eboot 

emh mf start edump eboot 

elw * # do anything! 

This file allows bgj , swj , and emh to access only themf s tart(8), edump(8), and eboot(8) commands; 
e lw can access all commands. 
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SEE ALSO 

autodump(8) for information about controlling the automatic dumping of the mainframe and the IOS-E 

boot sys(8) for information about booting the IOS-E and the mainframe 

cpuha 1 1 (8) for information about issuing a CPU master clear to stop the mainframe 

craymon(8) for information about monitoring the mainframe status and sets the OWS-E background color 

eboot(8) for information about booting one or more IOPs from the OWS-E 

econ(8) for information about configuring a MUXIOP-to-EIOP low-speed channel up or down 

ecrash(8) for information about examining an IOS-E dump image or a running system 

edump(8) for information about dumping IOS-E IOP local memory images to the OWS-E 

ehalt(8) for information about halting one or more IOPs from the OWS-E 

emon(8) for information about restarting the IOS-E error-logging, heartbeat, SMARTE, and CPU monitors 

eping(8) for information about sending an echo packet to an IOP from the OWS-E 

err logd(8) for information about the IOS-E hardware error-logging daemon 

estat(8) for information about checking IOP status 

dumpsys(8) for information about taking a dump image of UNICOS 

hbeat(8) for information about monitoring the IOS-E system 

hcon(8) for information about configuring a MUXIOP high-speed channel up or down 

mf dump(8) for information about dumping the mainframe memory and CPU registers to a CRI disk on the 

IOS-E 

mf init(8) for information about running a mainframe and IOS-E initialization and confidence test 
mf st art (8) for information about starting the mainframe CPUs from the OWS-E 
peek(8) for information about peeking (looking) at memory 
poke(8) for information about poking (placing) a pattern into memory 

rcpud(8) for information about processing service requests from the mainframe (IOS-E remote CPU 
daemon) 

z ip(8) for information about the program that acts as the terminal interface to a running CPU 
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NAME 



owse overview - An overview of the OWS-E commands 



DESCRIPTION 

The OWS-E commands may be grouped into the following audiences: 

• Operators 

• Adminstrators 

• Analysts 

• Other commands; that is, those not normally invoked manually 

In the following sections, each command is listed under the audience category to which it most often 
applies; this does not imply that a command may not be used by someone in another category. 

OPERATOR COMMANDS 

The following commands are normally invoked by an operator: 
boot sy s(8) Boots the IOS-E and the mainframe 

craymon(8) Monitors the mainframe status and sets the OWS-E background color (normally 

included in each operator's .xinitrc file) 

dumpdly(8) Performs an incremental (level-9) backup of the OWS-E file systems 

dump sy s (8) Takes a dump image of UNICOS 

dumpwkly(8) Performs a full (level-0) backup of the OWS-E file systems 

graphs (8) Displays CPU time statistics in graphic form 

z ip(8) Acts as the terminal interface to a running CPU 

ADMINISTRATOR COMMANDS 

The following commands are normally invoked by an administrator: 

autodump(8) Controls the automatic dumping of the mainframe and the IOS-E 

cpudump(8) Forces a UNICOS dump (however, the function of the cpudump command has 

been made obsolete by the new dumpsys(8) command) 

cpuha 1 1 (8) Issues a CPU master clear to stop the mainframe 

eboot(8) Boots one or more IOPs from the OWS-E 

econ(8) Configures a MUXIOP-to-EIOP low-speed channel up or down 

edump(8) Dumps IOS-E IOP local memory images to the OWS-E 

eha 1 1 (8) Halts one or more IOPs from the OWS-E 

emon(8) Restarts the IOS-E error-logging, heartbeat, SMARTE, and CPU monitors 

e s t a t (8) Checks IOP status 

hcon(8) Configures a MUXIOP high-speed channel up or down 

mf dump(8) Dumps the mainframe memory and CPU registers to a CRI disk on the IOS-E 

mf i n i t (8) Runs a mainframe and IOS-E initialization and confidence test 

mf start(8) Starts the mainframe CPUs from the OWS-E 

smdemon(8) Monitors the OWS-E system for SMARTE 
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smdstop(8) 

snmpget(l) 

snmpgetnxt(l) 

snmpnetstat(l) 

snmproute ( 8 ) 

snmpstatus(l) 

snmptrap(l) 

snmptrapd(l) 

snmpwalk(l) 

xsnmpmon(8) 



Terminates the SMARTE OWS-E system monitor daemon 
Communicates with a network entity by using SNMP GET requests 
Communicates with a network entity by using SNMP GET NEXT requests 
Shows network status by using SNMP 

Performs route tracing with the Simple Network Management Protocol 
Retrieves important information from a network entity 
Sends an SNMP TRAP message to a host 
Receives and logs SNMP TRAP messages 

Communicates with a network entity by using SNMP GET NEXT requests 
Invokes the SNMP network monitor 



ANALYST COMMANDS 

The following commands are normally invoked by an analyst: 

conv(8) Converts a file from old edump file format to new edump file format 

eping(8) Sends an echo packet to an IOP from the OWS-E 

ecrash(8) Examines an IOS-E dump image or a running system 

fyadmin(8) Controls the f y driver 

fy format (8) Formats raw trace buffer information extracted from f y driver modules 

f yroute(8) Sets or displays the f y driver's IP Interface Routing table 

olnet(8) Detects and isolates network problems with the OLNET on-line diagnostic network 

communications tool 

peek(8) Peeks (looks) at memory 

poke(8) Pokes (places) a pattern into memory 

COMMANDS USED BY OTHER COMMANDS 

The following commands are normally invoked by another command: 
cpud(8) Gathers data and disperses CPU time statistics 

cpupanic(8) Takes a UNICOS panic dump 

ediag(8) Boots deadstart diagnostic tests (dsdiag or cleario) into one or more 

specified IOPs 

e r r 1 ogd(8) IOS-E hardware error-logging daemon 

get con f ig(8) Retrieves system parameter values from the system configuration file 

hbeat(8) Monitors the IOS-E system 

iopha 1 1 (8) Dumps an IOP in the event of an IOP failure 

lapdaemon(8) Validates CRI tty fines for users 

newlog(8) Creates new errlog and ioplog files while backing up the existing ones 

rcpud(8) Processes service requests from the mainframe (IOS-E remote CPU daemon) 
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NAME 

autodump - Controls the automatic dumping of the mainframe and the IOS-E 



SYNOPSIS 

/home /localhost /cri /bin/ autodump on 
/ home / localhost/ cri/bin/aut odump off 



DESCRIPTION 

The autodump script creates (on) or deletes (off) the file associated with the DUMP parameter in the file 
/etc/conf igf ile. The existence of the file (determined by the values of ADUMPDIR and dump) 
controls the action of the mainframe and IOS-E automatic dump scripts, which are invoked by the 
hbeat(8) monitor. The autodump script is called by bootsys(8). (The bootsys script asks whether 
you want to enable automatic dumps; it then invokes autodump with the appropriate switch, depending 
upon your answer.) 

The arguments to the autodump command are as follows: 

on Creates the dump file and enables automatic dumping of the mainframe and IOS-E. 
off Deletes the dump file and disables automatic dumping of the mainframe and IOS-E. 
Permission to access this command is set in /etc/owsepermf ile by the system administrator. 



CONFIGURATION FILE PARAMETERS 

The autodump command reads the following parameters from /etc/conf igf ile: 

ADUMPDIR Defines the path name of the directory holding the dump lock file mentioned in the 

descriptions of the CPUPANIC and IOPHALT parameters. Default: 

/ home / localhost/ cri/bin/adm 

DUMP Defines the name of the dump lock file. Default: 

dump . on 

ENVIRONMENT VARIABLES 

OWSECONFIG Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 

FILES 



/etc/conf igf ile 
/etc/owsepermf ile 



Default OWS-E configuration file 

Permissions file that contains a list of accounts and the commands they are 
allowed to access 



SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

owsepermf ile(5) for information about the default OWS-E permission file 
bootsys(8) for information about the bootsys command, which calls autodump 
hbeat(8) for information about the heartbeat monitor 
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NAME 

bootsys - Boots the IOS-E and the mainframe 
SYNOPSIS 

/home/foca/ftart/cri/bin/bootsys [-c cluster] [-d diags] [-D] [-f filesystem] [-F] [-i] [-n] 
[-p parameter] [-u binary] [-v] [-w] 

DESCRIPTION 

The bootsys command boots the entire IOS-E and the mainframe. First it starts hbeat(8) to monitor for 
IOP halts and hangs, errlogd(8) to look for HISP errors, and smdemon(8) to monitor the OWS-E system 
for the System Maintenance and Remote Testing Environment (SMARTE). bootsys runs IOP boot-time 
diagnostic tests (unless specified otherwise), boots and configures each IOP, and runs a set of mainframe 
diagnostic tests by executing the mf init(8) program. Finally, bootsys boots the mainframe by 
executing the mf start(8) program and then, unless you specify the -w ("without zip") option, executes 
the z ip(8) command to provide you with the UNICOS console. As appropriate, bootsys passes the 
parameters specified on the bootsys command line to the commands it executes as appropriate. 

Normally, bootsys asks for confirmation before taking any potentially disruptive actions and asks you if 
you want to enable autodumps. You can force bootsys to not ask these questions by specifying the -F 
option. 

When you execute bootsys, you may receive an OWS-E message-of-the-day statement. This statement is 
located in a file specified by the MOTDPATH parameter in the system configuration file (which by default is 

/etc/conf igf ile). 

The bootsys command retrieves the information it needs (such as the configuration of the IOS-E and the 
binaries to be loaded) from the UNICOS parameter file. For more information about this file, see UNICOS 
System Administration, publication SG-2113. 

The arguments to bootsys are as follows: 

-c cluster Specifies the cluster number to be used to control the mainframe master clear deadstart 

lines. The range of valid cluster numbers depends on the number of clusters in the 
IOS-E. The default is 0. 

-d diags Specifies whether IOP boot-time diagnostics are to be run. diags can be set to one of the 

following: 

on Runs diagnostics before an IOP is booted 

off Does not run diagnostics before an IOP is booted 

on ly Runs diagnostics but does not boot the IOP. (The mainframe diagnostics 
are not run, and the mainframe is not booted.) 

If you do not specify this option, the default action is defined by the 
I0P_DIAGN0STICS variable in the file /etc/conf igf ile, which can be defined 
as either I0P_DIAGN0STICS on or I0P_DIAGN0STICS off .If this variable is 
not defined, on is the default. 

-D Sets debug mode in the appropriate commands called by bootsys and sends the output 

to standard error. 

-ffdesystem Specifies the path name of a RAM file system image to be used when mf s tart(8) boots 
UNICOS. 

-F Forces boot sy s not to ask for confirmation before booting the IOS-E and suppresses 

most informative messages. (Error messages will still appear.) 
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-l 



-p parameter 



-u binary 



-v 



Boots just the IOS-E. (The mainframe diagnostics are not run, and the mainframe is not 
booted.) 

(no execution) Goes through the steps of booting but does not actually boot the IOS-E or 
the mainframe. This is useful for catching syntax errors in the UNICOS parameter file. 

Specifies the path name of the parameter file to use. If you do not specify the -p option, 
the default parameter file is specified by the defaultuparamfile parameter in 
/etc/conf igf ile; by default, it is set to 
/ home / localhost / c r i / o s / u t s / par am. 

Specifies the path name of the UNICOS binary file to use. If you do not specify the -u 
option, the default UNICOS binary file is specified by the DEF AULTUKERNF ILE 
parameter in /etc/conf igf ile; by default, it is set to 
/home//0Ctf//?0 1 y//cri/os/uts/unicos. 



Sets verbose mode. This option forces the appropriate commands called by boot sys to 
print informative messages to standard error. 

-w (without z ip) Prevents the execution of the z ip(8) command at the end of the 

boot sys process. 

Permission to access boot sys and the commands it calls ~ autodump(8), ediag(8), mf init(8), 
mf start(8), and zip(8) -- is set in /etc/owsepermf ile by the system administrator. 

CONFIGURATION FILE PARAMETERS 

The bootsys command reads the following parameters from /etc/conf igf ile: 

AUTODUMP Defines the path name of the command that controls automatic dumping of 

the mainframe and the IOS-E. Default: 

/ home / to calhost/ cri/bin/au t odump 
DEF AULTUKERNF ILE Defines the path name to the default UNICOS binary. Default: 

/home//oca//i05'?/cri/os/uts/unicos 
DEFAULTUPARAMFILE Defines the path name to the default UNICOS parameter file. Default: 

/ home / localhost/ cri/os/uts/param 



EDIAG 



ERRLOGD 



HBEAT 



IOP DIAGNOSTICS 



IOPLOG 



MFINIT 



Defines the path name of the command that boots deadstart diagnostics into 
a specified IOP. Default: 

/home / localhost /cri/ smart e /bin/ ediag 

Defines the path name of the error logging daemon. Default: 

/ home / localhost I c r i / b i n / e r r 1 ogd 

Defines the path name of the IOP monitor. Default: 

/ home / localhost! cri/bin/hbeat 

Controls whether diagnostics are run by boot sys (8) before booting the 
IOS-E. Valid values are on, off, and only. Default: 

on 

Defines the path name of the IOP log file. Default: 

/ var / logs / ioplog 

Defines the path name of the command that runs a mainframe and IOS-E 
initialization and confidence test. Default: 



/home/toca^o^/cri/bin/mf init 
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MF START 



MAINFRAME 



MOTDPATH 



ROOTDIR 



SMDEMON 



Defines the path name of the command that starts the mainframe CPU from 
theOWS-E. Default: 

/home//0caZ/*0jJ/cri/bin/mf start 

Defines the type of mainframe to which the OWS-E is attached. Default: 

MAINFRAME token (replaced during installation) 

Specifies the path name of a file that contains text that used to convey 
information, such as system reconfiguration. By default, this parameter is 
commented out in /etc/conf igf ile. 

Defines the base directory used by scripts to find the CRI commands that 
they execute during processing. Default: 

/ home / localho st / cr i 

Defines the path name of the daemon that monitors the OWS-E for SMARTE. 
Default: 

/ home / localho st/ cri/smarte/bin / smdemon 



EXAMPLES 



Example 1: The following sample bootsys session uses the -n option to check the validity of the 
UNICOS parameter file and the -v option to produce informative messages (I0P_DIAGN0STICS is set to 
off): 



owsl600% bootsys -nv 

INFO: bootsys: no-execute mode - mainframe will not be booted. 

INFO: bootsys: Analyzing the parameter file ' /home/owsl600/cri/os/uts/param' 

Verifying root device accessibility. 

Verifying swap device accessibility. 



Diagnostics 
Boot cluster 
Unicos kernel 
Boot cluster 0, 
Boot cluster 0, 
Boot cluster 0, 
Boot cluster 0, 
Boot cluster 0, 
HISP cluster 0, 
HISP cluster 0, 
Boot cluster 1, 
Boot cluster 1, 
Boot cluster 1, 
Boot cluster 1, 
Boot cluster 1, 
HISP cluster 1, 
HISP cluster 1, 
owsl600% 



off 
0 

/home/owsl600/cri/os/uts/unicos 
iop 4 with /home/owsl600/cri/os/ios/iopmux 
iop 3 with /home/owsl600/cri/os/ios/eiop.dcal 
iop 2 with /home/owsl600/cri/os/ios/eiop . dca2 
iop 1 with /home/owsl600/cri/os/ios/eiop.bmx 
iop 0 with /home/owsl600/cri/os/ios/eiop.comm 
channel 010, mode cl00d200, target mainframe 
channel 014, mode cl00d200, target ssd 
iop 4 with /home/owsl600/cri/os/ios/iopmux 
iop 3 with /home/owsl600/cri/os/ios/eiop .hippi 
iop 2 with /home/owsl600/cri/os/ios/eiop.dca2 
iop 1 with /home/owsl600/cri/os/ios/eiop .dca2 
iop 0 with /home/owsl600/cri/os/ios/eiop .dca2 
channel 010, mode cl00d200, target mainframe 
channel 014, mode cl00d200, target ssd 
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Example 2: Suppose you wanted to boot the system using a UNICOS binary named newun i co s and a 
parameter file named newparam, rather than the defaults for these files. If your home directory were my d i r , 
you would enter the following: 

bootsys -u ~mydir/newunicos -p ~mydir /newparam 

Example 3: Suppose you always want to execute the -pand -v arguments whenever you execute bootsys. 
You can use the BOOTSYS_ARGS to specify this, as follows: 

setenv BOOTSYS_ARGS " -p ~mydir/myparam -v" (Cshell) 

or 

BOOTSYS_ARGS=" -p ~mydir/myparam -v" (Bourne shell) 
export BOOTSYS_ARGS 

ENVIRONMENT VARIABLES 

BOOTSYS_ARGS Specifies options and arguments that are always executed when you execute 

bootsys 

OWSECONFIG Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 

FILES 

/etc/conf igf ile Default OWS-E configuration file 

/etc/owsepermf ile Permissions file that contains a list of accounts and the commands they are 

allowed to access 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator' s Guide, publication SG-3079, for 
information about /etc/conf igf ile 

owsepermf i le(5) for information about the default OWS-E permission file 

autodump(8) for information about controlling automatic dumping of the mainframe and the IOS-E 

eboot(8) for information about booting the IOS-E from the OWS-E 

econ(8) for information about configuring a MUXIOP-to-EIOP low-speed channel up or down 

err logd(8) for information about the IOS-E hardware error-logging daemon 

hbeat(8) for information about monitoring the IOS-E system 

hcon(8) for information about configuring a MUXIOP high-speed channel up or down 

mf ini t(8) for information about running a mainframe initialization and confidence test 

mf s tart(8) for information about starting the mainframe CPU from the OWS-E 

smdemon(8) for information about the SMARTE daemon 

z ip(8) for information about the command that acts as the terminal interface to a running CPU 
I/O Subsystem Model E (IOS-E) Guide, publication SD-2107, for illustrated descriptions of system deadstart. 
(This document contains information private to Cray Research, Inc. It can be distributed to non-CRI 
personnel only with approval of the appropriate Cray Research manager.) 
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NAME 

conv - Converts a file from old edump file format to new edump file format 
SYNOPSIS 

/home / localhost / cxi /bin/ conv [-s serial] oldformat newformat 
DESCRIPTION 

The conv command reads a specified file {oldformat), converts it from the old edump file format into the 
new edump file format, and names the converted file newformat. The old file is not deleted. 

The arguments to conv are as follows: 

- s serial Specifies the mainframe serial number for identification purposes 

oldformat Specifies the file to be converted 

newformat Specifies the name of the converted file 

EXAMPLES 

The following example converts a dump file named dump .2.10 from the old file format to the new, 
specifies the serial number, and names the new file dump .2.10. new: 

conv -s 1600 dump. 2. 10 dump . 2 . 10 .new 

SEE ALSO 

ecrash(8) for information about using the IOS-E dump files 
edump(8) for information about dumping the IOS-E 

OWS-E Operator Workstation Administrator' s Guide, publication SG-3079, for information about the file 
format 
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NAME 

cpud - Gathers data and disperses CPU time statistics 

SYNOPSIS 

/ home / localhost/ cri/bin/cpud [-D] 

DESCRIPTION 

The cpud daemon gathers mainframe CPU statistics. It then listens on a socket (base port + 2 by default) 
for graphs(8) client connections, and sends out the gathered data to those clients connected. 

The argument to cpud is as follows: 

-D Sets debug mode in the cpud program and sends the output to standard error. 

First cpud determines the starting location in memory where the pws (processor working storage) kernel 
data structure resides. Then it looks at the pws structure in mainframe memory via the IOS-E. 

This data is converted to Sun words (32 bits), and then written on the socket. This makes the data available 
to all graphs clients listening on that socket. 

This command must be started manually when you are root. Permission to access this command is set in 
/etc/owsepermf ile by the system administrator. 

CONFIGURATION FILE PARAMETERS 

The cpud command reads the following parameters from /etc/conf igf ile: 

BASEPORT Defines the starting port value used for the various operator interface software 

daemons. Default: 

4370 

FILES 

/etc/ ows epermf ile Permissions file that contains a list of accounts and what commands 

they are allowed to access 

/etc/conf igf ile Default configuration file where baseport is defined 

RETURN VALUES 

If the cpud program completes successfully, a value of 0 is returned. If an error is encountered, a value of 
1 is returned. 

SEE ALSO 

configf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 

information about /etc/conf igf ile 

graphs (8) for information about displaying CPU time statistics 
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NAME 

cpudump - Forces a UNICOS dump 

SYNOPSIS 

/ home / localhost/ cri/bin / cpudump 

DESCRIPTION 

The function of the cpudump command has been made obsolete by the new dumpsys(8) command. It is 
still provided with the OWS-E 2.0 release for backward compatibility, but it will be deleted in a future 
release. 

The cpudump script allows you to force a dump of UNICOS. cpudump boots enough of the IOS-E to 
communicate with the dump device, then invokes mf dump to place a dump image on the disk slice 
specified by the mainframe dump configuration parameters DIOPATH, dlen, DSTART, DTYPE, and 
DUNIT in /etc/conf igf ile. The cpudump command logs its action in /var/logs/dumplog. 

CONFIGURATION FILE PARAMETERS 

The cpudump command reads the following parameters from /etc/conf igf ile: 



DIOPATH 



DLEN 



DSTART 



DTYPE 



DUNIT 



Defines the path that the memory dump will take from the mainframe to the disk. 
Default: 

DUMP 10 token (replaced during installation) 

Defines the length, in sectors, of the disk slice to which the memory will be 
dumped. Default: 

DUMPLEN token (replaced during installation) 

Defines the starting sector of the disk slice to which the memory will be dumped. 
Default: 

DSTARTBL token (replaced during installation) 

Defines the type of the disk to which the mainframe memory will be dumped. 
Default: 

DUMPTYPE token (replaced during installation) 

Defines the default dump device unit that the mf dump(8) command uses when 
routing the mf sysdmp binary file to the mainframe before the dump. Default: 

DUMPUNIT (replaced during installation) 



FILES 



/etc/conf igf ile 
/var/logs/dumplog 



Default OWS-E configuration file 
Default UNICOS dump log file 



SEE ALSO 



conf igf ile(5) and OWS-E Operator Workstation Administrator' s Guide, publication SG-3079, for 
information about /etc/conf igf ile 

cpupanic(8) for information about taking a UNICOS panic dump 
dumpsys(8) for information about taking a dump image of mainframe memory 

mf dump(8) for information about dumping the mainframe memory and CPU registers to a CRI disk on the 
IOS-E 
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NAME 

cpuhalt - Issues a CPU master clear to stop the mainframe 
SYNOPSIS 

/home//ocfl//zo5?/cri/bin/cpuhalt [-c cluster] [-D] [-F] 
DESCRIPTION 

The cpuhalt command sends an S-packet to the MUXIOP in the designated cluster, requesting that the 
MUXIOP issue a CPU master clear. The MUXIOP must be running when this command is issued; otherwise, 
the command will time out. In normal operation, this command should only be used when UNICOS is in 
single-user mode and all caches have been flushed to disk. 

The argument to cpuhalt is as follows: 

-c cluster Specifies the number of the IOS-E that controls the mainframe master clear and deadstart 

lines. The range of valid cluster numbers depends on the number of clusters in the IOS- 
E. The default is 0. 

-D Sets debug mode in the cpuhalt program and sends the output to standard error. 

-F Forces cpuhalt not to ask for confirmation before issuing a master clear and 

suppresses most informative messages. (Error messages will still appear.) 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 

CONFIGURATION FILE PARAMETERS 

The cpuhalt command reads the following parameter from /etc/conf igf ile: 
IOPLOG Defines the path name of the IOP log file. Default: 

/ var / logs / ioplog 

FILES 

/etc/owsepermf ile Permissions file that contains a list of accounts and the commands they are 

allowed to access 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

owsepermf i le(5) for information about the default OWS-E permission file 
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NAME 

cpupanic - Takes a UNICOS panic dump 
SYNOPSIS 

/ home / localhost/ cri/bin / cpupan i c reason 
DESCRIPTION 

When a UNICOS panic occurs, cpupanic boots the IOS-E and takes a dump image of the mainframe CPU 
by calling the dumpsys(8) command, cpupanic places this dump on the disk slice specified by the 
mainframe dump configuration parameters, cpupanic logs this action in /var/ logs /dump log and 
sends mail to the login name specified by the MAIL_CPUFAIL parameter in /etc/conf igf ile. By 
default, this parameter is set to cr i. 

The rcpud(8) daemon calls cpupanic. Usually, cpupanic is used as part of a script. In the rare event 
that you enter it directly, you can enter a reason, as shown by reason in the SYNOPSIS line. 

The argument to cpupanic is as follows: 

reason Specifies the reason cpupanic was entered, reason is truncated after 79 characters, not 

including quotation marks (a longer reason will not cause an error, but the 80th and 
succeeding characters will not be used). If you specify more than one reason, only the 
first one encountered is used. 

The system administrator should modify the parameters listed in "CONFIGURATION FILE PARAMETERS" 
to site-specific values. 

CONFIGURATION FILE PARAMETERS 

The cpupanic command reads the following parameters from /etc/conf igf ile: 
defaultuparamfile Defines the path name to the default UNICOS parameter file. Default: 

/home/Zoca/Zjosf/cri/os/uts/param 
MAIL_CPUFAIL Defines the login name to which mail is sent if a CPU panics. Default: 

cri 

FILES 

/etc/conf igf ile 
/var/ logs /dumplog 
/home / localhost/ 'cri /os/uts /param 

SEE ALSO 

aliases(5) for information about the SunOS file for sendmail(8) 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 

information about /etc/conf igf ile 

cpudump(8) for information about forcing a UNICOS dump 

dumpsys(8) for information about the command that takes a dump image of UNICOS 

rcpud(8) for information about the daemon that processes service requests from the mainframe and calls 

cpupanic 

UNICOS System Administration, publication SG-2113. 



Default OWS-E configuration file 
Default UNICOS panic log file 
Default UNICOS parameter file 



SR-3077 2.0 



34 



Cray Research, Inc. 



CRAYMON(8) 



CRAYMON(8) 



NAME 

craymon - Monitors the mainframe status and sets the OWS-E background color 
SYNOPSIS 

/home//oca//i(9^/cri/bin/craymon [-n] [-r seconds] 
DESCRIPTION 

The craymon command continually monitors the table produced by the hbeat(8) command to determine 
whether the mainframe is running and sets the background color of the OWS-E accordingly. As long as the 
mainframe is running properly, craymon sets the background of the OWS-E to the first color specified by 
the CRAYMON parameter in /etc/conf igf ile; if the mainframe is not running, craymon sets the 
background to the second color specified by CRAYMON. By default, the background is set to SkyBlue 
when the mainframe is running and to red when it is not. 

Normally, the operator should have the following line set in the . xinitrc file: 
craymon & 

This specifies that craymon will execute in the background for as long as the operator is logged in. 
The arguments to craymon are as follows: 

-n (no-looping) Forces craymon to read the hbeat table just once, changing the 

background color as necessary. This option is useful if you suspect that your original 
craymon process has died and you want to determine the status of the mainframe. 

-r seconds (rate) Specifies the rate, in seconds, at which craymon will check the hbeat table. The 
default is 15. 



NOTES 

If you change the color values in /etc/conf igf ile after invoking craymon, you must force 
craymon to reread the values by sending it a SIGUSR1 signal. To do this, you must determine the 
process ID number of the craymon program and then use the kill command to send the signal. For 
example, suppose that the ps command shows a process ID number of 23 9 for craymon; you could then 
enter the following to send a SIGUSR1 signal to craymon: 

kill -SIGUSR1 239 



CONFIGURATION FILE PARAMETERS 

The craymon command reads the following parameters from /etc/conf igf ile: 

craymon Defines the colors of the OWS-E that denote whether the mainframe is up 

(first color) or down (second color). The colors must consist of one word 
each and they must be separated by a comma; spaces cannot appear within 
or between the two colors. Default: 

SkyBlue, red 

1 0 PLOG Defines the path name of the IOP log file. Default: 

/var / logs/ ioplog 
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SERIALNUMBER Defines the serial number of the CRI mainframe to which the OWS-E is 

attached. Default: 

SERIALNUMBER token (replaced during installation) 

EXAMPLES 

The following example specifies that craymon should read the hbeat table once every minute: 

craymon -r 60 

ENVIRONMENT VARIABLES 

owseconfig Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 

FILES 

/usr/openwin/lib/rgb . txt Default colors file 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 

information about /etc/conf igf ile 

hbeat(8) for information about monitoring the IOS-E system 
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NAME 

dumpdly - Performs an incremental (level-9) backup of the OWS-E file systems 



SYNOPSIS 

/ home / localhost/ cr i /bin/ dumpd ly 



DESCRIPTION 



NOTES 



The dumpdly ("dump daily") script calls the SunOS dump(8) utility with the various file systems 
configured on the OWS-E. You should use it every day to perform an incremental (level-9) backup of the 
system, which will produce a dump of all files that have changed since the previous lower-level backup. 
Every week, you should run the dumpwkly ("dump weekly") script to perform a full (level-0) backup of 
the complete system. 

By using the dumpdly and dumpwkly scripts as directed, you will ensure valid backups as well as save 
on the actual time necessary to perform the backups. Use the restore(8) command to restore a dump to 
a system. (The restore command is part of SunOS.) 

If you want to be certain that no files change while you are performing the dump, execute dumpdly in 
single-user mode on the OWS-E. 



The dumpdly script assumes the following file system configuration: 

File System Mounted On 

/dev/sdOa / 

/dev/sdOd /usr 

/dev/sdOg /home 

/dev/sdOh /home/ localhost /cri 

/dev/sdOf /var 



If the site's configuration does not match this, the system administrator must modify the dumpdly script to 
ensure valid backups. 



SEE ALSO 

dumpwkly(8) for information about the script that performs weekly level-0 dumps 

dump(8) and res tore(8) in Sun Microsystem SunOS Reference Manual for more details about these 

utilities and level-9 and level-0 backups 

OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for more information about 
backup procedures 
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NAME 



dumpsys - Takes a dump image of UNICOS 



SYNOPSIS 



/ home /localhost/ cri /bin /dumpsys [-b bootstrap] [-c cluster] [-D] [-f mfsysdmp] [-F] [-i] 
[-1 iosdump] [-n] [-p paramfile] [-v] [reason] 



DESCRIPTION 



The dumpsys command takes a dump image of UNICOS. dumpsys reads the UNICOS parameter file, 
boots the MUXIOP that has the deadstart line to the mainframe (which can be modified by the -c option), 
and stops the mainframe. It then boots the disks and MUXIOPs needed for the dump device (as specified in 
the UNICOS parameter file) and writes the mainframe system dump binary file, dumpsys then writes the 
exchange package into mainframe memory and starts the mainframe, polling for status returns from the 
dump binary file until it times out after 1 minute of inactivity or when a success or failure is encountered. 
Finally, it stops the mainframe and IOPs. 

The arguments to dumpsys are as follows: 

-b bootstrap Specifies the full path name of the bootstrap loader program for the CPU. If you do not 
specify this option, the program used will be the one specified by MFBOOT in 
/etc/conf igf ile; by default, this program is 
/home / localhost / cr i / os / uts /mf boot. 



-c cluster 
-D 

- f mfsysdmp 



-I iosdump 



-p paramfile 



-v 



Specifies the cluster through which the dump image will be taken. The default is 0. 

Sets debug mode in dumpsys and sends the output to standard error. 

Specifies the mainframe system dump binary file. The default is specified by MFSYSDMP 
in /etc/conf igf ile; at release, MFSYSDMP is set to 
/ home / localhost/ cr i / o s /u t s /mf sy s dmp. 

Forces dumpsys not to ask for confirmation before dumping the mainframe and 
suppresses most informative messages. (Error messages will still appear.) 

Boots the required portions of the IOS-E but does not write the mainframe system dump 
binary file nor the exchange package and does not start the mainframe. This option is 
useful when you want to use the mf dump(8) command after executing dumpsys. It is 
not logical to use the - f or -b options with this option. 

Specifies a name for an accompanying IOS-E dump file that resides on the OWS-E; this 
action would usually be performed with edump -e . This option will be useful with 
future releases of the UNICOS crash(8) command; UNICOS implementation is 
currently deferred. 

(no execution) Goes through the steps of dumping but does not actually dump the 
mainframe. This is useful for catching syntax errors. 

Specifies the parameter file that describes the system. The default for parameter is 
specified by the DEFAULTUPARAMFILE parameter in /etc/conf igf ile; at 
release, DEFAULTUPARAMFILE is set to /home/Zflca/fawf/cri/os/uts/param. 

Sets verbose mode. This option forces dumpsys to print informative messages to 
standard error. 
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reason Specifies the reason for the dump; for example, " CPU Hung ". Quotation marks are 

optional, even if the reason contains white space; however, you should use them to avoid 
problems with special characters, reason is truncated after 79 characters, not including 
quotation marks (a longer reason will not cause an error, but the 80th and succeeding 
character will not be used). Entering a halt code as a reason helps to distinguish dumps 
as dump files start to accumulate. 

EXAMPLE 

If you want to specify cluster 1 rather than cluster 0, a parameter file named pa ram .test, and verify 
your syntax, enter the following: 

owsl600% dumpsys -c 1 -p par am. test -nv 

INFO: dumpsys: no-execute mode - mainframe will not be dumped. 
INFO: dumpsys: Analyzing the parameter file 'param. test ' . 
Bootstrap binary : /home/owsl600/cri/os/uts/mfboot 
Mfsysdump binary : /home/owsl600/cri/os/uts/mf sysdmp 
Dump via cluster : 1 

Boot cluster 1, iop 4 with /home/owsl600/cri/os/ios/iopmux 
Boot cluster 1, iop 0 with /home/owsl600/cri/os/ios/eiop.dca2 
Dump 2 CPUs, 2 cluster registers 

Dump table memory, cluster registers, v, b, t registers - without force 

Dump CPU from 00000000000 to 00010000000 

Dump CPU from 00170000000 to 00200000000 

Dump SSD from 00000000000 to 00020000000 

Dump date : 03/02/92 time : 16:34:46 

Dump device information :- 

0: channel 022, iopath 00601034, type 10, unit 3, start 0, length 17250 

CONFIGURATION FILE PARAMETERS 

The dumpsys command reads the following parameters from /etc/configfile: 

DEF AULTUPARAMF I LE Defines the path name to the default UNICOS parameter file. Default: 

/home/tolte/cri/os/uts/param 
ioplog Defines the path name of the IOP log file. Default: 

/var/logs/ioplog 

MFBOOT Defines the path name of the bootstrap loader program used by the 

mf dump(8) command. Default: 

/home/focaZ/zosf/cri/os/uts/mfboot 

MFSYSDMP Defines the path name of the CPU-resident program used by the mf dump(8) 

command. Default: 

/home/ localhost / cri/os/uts /mf sysdmp 
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ENVIRONMENT VARIABLES 



OWSECONFIG 



Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 



FILES 



etc/conf igf ile 



Default OWS-E configuration file 



SEE ALSO 



conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

edump(8) for information about dumping IOS-E IOP local memory images to the OWS-E 

mf dump(8) for information about manually dumping the mainframe memory and CPU registers to a CRI 

disk on the IOS-E 



SR-3077 2.0 



40 



Cray Research, Inc. 



DUMPWKLY(8) 



DUMPWKLY(8) 



NAME 

dumpwkly - Performs a full (level-0) backup of the OWS-E file systems 

SYNOPSIS 

/ home / localhost/ cri/bin / dumpwk ly 

DESCRIPTION 

The dumpwkly ("dump weekly") script calls the SunOS dump(8) utility along with the various file 
systems configured on the OWS-E. You should use it every week to perform a full (level-0) backup of the 
complete system. Every day, you should perform an incremental backup with the dumpdly ("dump 
daily") script to back up those files that have changed since the previous level-0 backup. 

By using the dumpdly and dumpwkly scripts as directed, you will ensure valid backups as well as save 
on the actual time necessary to perform the backups. Use the restore(8) command to restore a dump to 
a system. (The restore command is part of SunOS.) 

If you want to be certain that no files change while you are performing the dump, execute dumpwkly in 
single-user mode on the OWS-E. 

NOTES 

The dumpwkly script assumes the following file system configuration: 
File System Mounted On 

/dev/sdOa / 

/dev/sdOd /usr 

/dev/sdOg /home 

/dev/sdOh /home / localhost/ cri 

/dev/sdOf /var 

If the site's configuration does not match this, the system administrator must modify the dumpwkly script 
to ensure valid backups. 



SEE ALSO 



dumpdly (8) for information about the script to perform daily level-9 dumps 

dump(8) and restore(8) in Sun Microsystem SunOS Reference Manual for more details about these 
utilities and level-9 and level-0 backups 

OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for more information about 
backup procedures 
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NAME 

eboot - Boots one or more IOPs from the OWS-E 
SYNOPSIS 

/Yiome/localhost/cri/hin/ehoot [-d] [-D] [-F] [-h] [-M] [-v] cluster :iop -.file 
[cluster : iop :file] ... 

/home / localhost/ cri /bin/ eboot [-d] [-D] [-F] [-h] [-M] [-v] -c cluster -i iop -f file 
DESCRIPTION 

The eboot command loads a selected I/O processor (IOP) with a binary file (specified with the - f option) 
and deadstarts the IOP. eboot records its actions in the file specified by the ioplog variable in 
/etc/conf igf ile (which at release is set to /var/logs/logf ile). 

Usually, you will use the boot sys(8) command to boot the system, rather than the eboot command. 
For normal system operation, use the econ(8) command to configure up a channel between an EIOP and 
the MUXIOP and use the hcon(8) command to configure up the MUXIOP high-speed channels. 

Normally, eboot asks for confirmation before taking any action. You can force eboot to not ask for 
confirmation by specifying the -F option. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 

You must specify either cluster -.iop -.file or the -c, -i, and -f options. The arguments to the eboot 
command are as follows: 

cluster : iop : file [cluster : iop : file] ... 



Specifies the cluster and IOP that should be booted with the specified binary file; at least 
one set of cluster : iop -.file must be specified. You may specify more than one set of 
cluster : iop -.file if you separate the sets with white space. 

The range of valid values for cluster consists of integers from 0 through 15, depending 
upon the hardware configuration at you site, cluster may be a single integer, a list of 
integers separated by commas, or a range of integers separated by a hyphen. 

The range of valid values for iop consists of integers in the range 0 through 4, 
depending upon the hardware configuration at your site, iop may be a single integer, a 
list of integers separated by commas, or a range of integers separated by a hyphen. 

The specified file may begin with a tilde character (~), which is expanded to the home 
directory of the login name that follows the tilde or, if not followed by a login name, to 
your home directory. 

For examples of legal syntax, see the "EXAMPLES" section. 



-d 



Sets debug mode in the IOPs booted. 



-D 



Sets debug mode in the eboot program and sends the output to standard error. 



-F 



Forces eboot to not ask for confirmation before booting an IOP and suppresses most 
informative messages. (Error messages will still appear.) 



-h 



Sets headerless load mode. Use this option when the file you specify does not have a 
header. If you do not specify this option, the eboot program strips the 64-byte 
segldr(l) header from the binary file; if there is no header, information will be lost. 
(By default, IOP binaries include a 64-byte a . out header.) 



-M 



Issues the cluster master clear function. If booting the MUXIOP, a cluster master clear is 
issued to all IOPs in the cluster. CAUTION: this stops any other IOPs running in that 
cluster; therefore, you should specify the MUXIOP before other clusters. 
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-v Sets verbose mode. This option forces eboot to print informative messages to standard 

error. 

-c cluster Specifies the IOS-E cluster number. The range of valid cluster numbers depends on the 

number of clusters in the IOS-E. If you specify this option, you must also specify - i and 
-f. 

- i iop Specifies the number of the IOP to be booted, iop can be an integer in the range 0 

through 4 (4 indicates the MUXIOP; 0 through 3 indicate EIOPs) or mux for the 
MUXIOP. If you specify this option, you must also specify -c and -f . 

- f file Specifies the path name of the binary file to boot. If you specify this option, you must 

also specify -c and -i. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 

EXAMPLES 

All of the following example formats are legal: 

eboot 0:1: /home/owse/cri/os/ios/bootit 

eboot 0:1: /home/owse/cri/os/ios/boot .1 0:2: /home/owse/ cri/os/ios/boot . 2 
eboot 0 , 5 : 0 : /home/owse/cri/os/ios/bootit 
eboot 1-15:0, 4 : ~cri/os/ios/bootit 

The following example loads and deadstarts the / username I e iop binary file into IOS 0, cluster 4, IOP 3: 

eboot -c 4 -i 3 -f / username I eiop 

CONFIGURATION FILE PARAMETERS 

The eboot command reads the following parameter from / etc/ con f igf ile: 
I o plog Defines the path name of the IOP log file. Default: 

/var/logs/ioplog 

RETURN VALUES 

When eboot executes properly, the return value is 0. If an error occurs, the return value will be 1. If the 
binary file cannot be found, the return value will be 2. 

FILES 

/etc/conf igf ile Default OWS-E configuration file 

/etc/owsepermfile Permissions file that contains a list of the accounts that may access 

each command 

/ var / logs / ioplog Default file that stores a history of IOPs that have been booted 
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SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator' s Guide, publication SG-3079, for 
information about /etc/conf igf ile 

ows epermf i 1 e(5) for information about the default OWS-E permission file 
bootsys(8) for information about the command that boots the IOS-E and the mainframe 
econ(8) for information about configuring the MUXIOP-to-EIOP low-speed channel 
hcon(8) for information about configuring the MUXIOP high-speed channel 

segldr(l) in UNICOS User Commands Reference Manual, publication SR-2011, for information about 
linking relocatable object modules to produce an executable program 

I/O Subsystem Model E (IOS-E) Guide, publication SD-2107, for illustrated descriptions of system deadstart. 
(This document contains information private to Cray Research, Inc. It can be distributed to non-CRI 
personnel only with approval of the appropriate Cray Research manager.) 
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NAME 

econ - Configures a MUXIOP-to-EIOP low-speed channel up or down 
SYNOPSIS 

/home//oca//20S?/cri/bin/econ [-c cluster] [-d] [-D] eiop 
DESCRIPTION 

The econ command configures a MUXIOP-to-EIOP low-speed channel up by default. The channel is 
configured down if you specify the -d option. The MUXIOP of the designated cluster must be running. 

The arguments to econ are as follows: 



-c cluster Specifies the cluster in which the MUXIOP resides; the range of valid cluster numbers 

depends on the number of clusters in the IOS-E. The default is 0. 

-d Configures the channel down. If you do not specify this option, econ configures the 

channel up. 

-D Sets the debug mode in the econ program and sends the output to standard error. 

eiop Specifies the EIOP number, which can be an integer in the range 0 through 3 . 



Log messages generated by this command are sent to the file specified by the IOPLOG parameter in 
/etc/conf igf ile. By default, IOPLOG is set to /var/ logs/ ioplog. Error messages are written 
to standard error. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 
EXAMPLES 

The following example configures down a MUXIOP low-speed channel to IOS 0, cluster 3, EIOP 2: 

econ -d -c 3 2 

CONFIGURATION FILE PARAMETERS 

The econ command reads the following parameter from /etc/conf igf ile: 
IOPLOG Defines the path name of the IOP log file. Default: 

/var / logs / ioplog 

FILES 

/etc/conf igf ile Default OWS-E configuration file in which IOPLOG is specified 

/etc/owsepermf ile Permissions file that contains a list of accounts that may access each 

command 

/var/logs/ioplog Default IOP log file 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/con figfile 

owsepermf ile(5) for information about the default OWS-E permission file 
hcon(8) for information about configuring a MUXIOP high-speed channel up or down 
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NAME 

ecrash - Examines an IOS-E dump image or a running system 
SYNOPSIS 

/home /localhost /cri/ bin /ecrash [-f file] [script] 
DESCRIPTION 

The ecrash command is an interactive utility for examining either an IOS-E dump image file (off-line 
mode) or a running system (on-line mode). It allows you to examine registers, the exit stack, flags, local 
memory, and channel buffers. On running systems, it also includes an IOS-E debugger and allows you to 
examine CPU and SSD memory. 

Note: ecrash commands can no longer be abbreviated. Also, you must enclose statements in quotation 
marks where noted. 

The arguments to ecrash are as follows: 

- f file Specifies the dump file that you want to examine with ecrash. Specify the complete 

path name if the file is not in your current directory. If you do not specify this option, 
ecrash will assume that it is trying to process a running system and will proceed to 
look at the actual hardware. 

When you enter ecrash, the prompt reminds you of the cluster and IOP numbers being 
used; for example, thecO-iO-> prompt reminds you that you are using cluster 0 and 
IOP 0. 

script Specifies an executable file that contains ecrash built-in commands to be executed. 

See "BUILT-IN COMMANDS." 

Upon invocation, ecrash reads and executes ecrash built-in commands listed in the 
$HOME/ . ecrashrc file (if it exists and is readable). Thereafter, ecrash reads commands from 
standard input or a script file. Use a new-line character to separate commands; you can use braces ({ }) to 
group commands to form a single statement, ecrash supports a set of mathematical operators and simple 
program-flow statements such as while and for loops. 

The ecrash program has some characteristics of a programming language and was modeled after the C 
language. The following sections describe the built-in commands, the use of expressions and registers, flow 
control, and I/O redirection. 

Permission to access this command in on-line mode is set in /etc/owsepermf ile by the system 
administrator. 

BUILT-IN COMMANDS 

The ecrash program contains the following built-in commands: 

address Displays the number of words specified by the words command or the WORDS 

variable, starting at address in memory. 

+ [expression] Moves forward expression locations in memory and displays the number of 

subsequent words specified by the words command or the WORDS variable. The 
default is 1 word. 

- [expression] Moves backward expression words in memory and displays the number of 

preceding words specified by the words command or the WORDS variable. The 
default is 1 word. 
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+ expression 



<RETURN>) 



Adds this offset (.expression) to the beginning address of the currently displayed 
memory, then displays the subsequent number of words specified by the words 
command or the WORDS variable. If you are displaying CPU or channel buffer 
memory, expression is interpreted as words; if you are displaying local IOP 
memory, expression is interpreted as parcels. 

Displays the number of subsequent words ("page forward") in memory specified 
by the words command or WORDS variable, starting from the last displayed 
address. 



calc expression 



cb [expression] 



Displays the number of preceding words ("page back") in memory specified by 
the words command or WORDS variable, from the beginning address of the 
current memory display. This is valid only in on-line mode. 

Repeats the last command line. 

Displays command summary information; this is the same as the help command. 

Displays the A register. If you are examining a running system, this command is 
valid only when you are in the debugger on the IOS-E. 

Displays the B register. If you are examining a running system, this command is 
valid only when you are in the debugger on the IOS-E. 

Displays the C register. If you are examining a running system, this command is 
valid only when you are in the debugger on the IOS-E. 

Calculates and displays the specified expression in octal, hexadecimal, and signed 
and unsigned decimal forms. 

Sets the current memory type to the channel buffer accessed by channel 
expression. The default is channel 030. See also cpu, local, and ssd. 

change type [expression] 

Changes memory, register, stack, and so on in an IOP if it is in the IOS-E debugger. 
If you specify type without expression, you will receive the current value for type 
and will be asked if you want to change it; if you specify expression with type, the 
value of expression will be immediately used, type can be set to one of the 
following: base (IOS-E base register); a (A register); b (B register); c (C 
register); e (E register); r [expression] , in which expression must evaluate to a 
number in the range 0 to 0 177 (R register); e [expression] , in which expression 
must evaluate to a number in the range 0 to 0 3 7 (E stack), type can also be an 
expression itself, in which case the value of the expression is used as an address in 
the currently selected memory target. Note that you must literally enter the 
brackets shown in e [ expression ] and r [ expression ] . 

cluster [expression] Sets the current cluster number to expression. The legal range for expression is an 
integer from 0 through 15; if expression evaluates to an invalid number, the next 
access attempt will report an error. 

Displays CPU memory. See also cb, local, and ssd. 

Exits the debugger. 

Enters the debugger. 



cpu 

debug off 
debug on 
display [type] 



Sets the display base type to either octal or hexadecimal; type can be set to either 
oct (octal) or hex (hexadecimal). The default is oct. 

Displays the E pointer. When you are on a running system, this command is valid 
only when you are in the debugger on the IOS-E. 
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e n 



flags [expression] 



format type 



Displays the E stack entry n; n can be set to an integer value from 0 through 040 
(octal). When you are examining a running system, this command is valid only 
when you are in the debugger on the IOS-E. 

Displays the specified expression channel flags; the default is to print all channel 
flags. If you are on a running system, this command is valid only when you are in 
the debugger on the IOS-E. 

Sets the memory display format according to the type specified, type can be one 
of the following: 



bit Displays memory as a bit field 

by t e Displays memory as bytes 

e lan Displays local memory as IOS-E elan instructions 

par ce 1 Displays memory as parcels 

word Displays memory as words 

he lp Prints a usage summary for on-line or off-line mode, depending upon the current 

mode. Because the output may be more than one screenful, you may want to pipe 
it through a pager such as the SunOS more(l) command. This command is the 
same as the ? command. 

i Displays the Interrupt Enable flag. This command is valid only when you are in 

the debugger on the IOS-E or for a dump. 

inc lude "file " Reads input from the specified file until the end-of-file character; you must 

enclose file in quotation marks. If the file cannot be opened, ecrash will issue 
an error message. You can have up to 10 nested include statements. 

issue [channel] [function] [Areg] 

Reads a channel state if only a channel number is specified, or reads a channel 
state and issues a channel function as follows (this command is valid only when 
you are in the debugger on the IOS-E): 

channel Specifies the channel number; channel can be set to an integer from 
0 through 6553 6. 

function Specifies the function; function can be set to an integer from 0 
through 6553 6. 

A register Specifies the contents of the accumulator register at the time the 
function is issued; register can be set to an integer from 0 through 
65536. 0 is the default. 

The following example issues function 17 (octal) with accumulator register 3 to 
channel 20 (octal): 

issue 20 17 3 



local Sets the current memory type to IOP local memory. See also cb, cpu, and s s d. 

od 

od address 

od address , amount 

od address , amount , format 

Formats and displays the currently selected memory type. 

address Specifies the address to be dumped; address can be an expression. The 
default is 0. 
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amount Specifies the number of words to display; amount can be an expression. 
The default is the value to which the words command or WORDS 
variable is set. See "VARIABLES." 

format Specifies the format of the dump; the current format is the default. 

od -r Formats and dumps all registers. You can use this option for dumps or for examining 

a running system in the debugger. 

p Displays the program counter. You can use this option for dumps or on a running 

system in the debugger. 

processor [expression] 

Sets the IOP number to expression; expression can be set to an integer from 0 through 
4 (4 is theMUXIOP). The default is 0 . This is equivalent to setting the IOP variable 
as follows: IOP=expression 



quit [expression] 



register [expression] 



Quits the ecrash program, expression specifies theexitcode; the defaultfor 
expression is 0. 

I 

Displays registers memory starting with expression. The number of registers 
displayed is controlled by the WORDS variable and the words command, expression 
can be set to an integer value from 00 through 0177 (octal). The default is 0. You 
can use this option for dumps or on a running system in the debugger. 



set [addressl] 

set [addressl, addressl] 



ssd 
status 



trace [expression] 

unset [addressl] 
unset [all] 

words [expression] 



Sets a single breakpoint at addressl or a double breakpoint at addressl and 
address!; addressl and address2 can be set to an integer from 0 through 6 5 5 3 6 . On 
a single breakpoint, the IOS-E resets the breakpoint. On a double breakpoint, the 
breakpoint stays set. This command is valid only when you are in the debugger. 

Displays SSD memory. See also cb, cpu, and local. 

Shows the current status of ecrash. This command is mode-dependent. In off-line 
mode, it shows the following: the contents of the dumpfile being examined; the date 
and time of the dump; the serial number of the machine being dumped (if specified in 
the dump); and the reason, if any, for the dump. In on-line mode, it shows the 
following: which IOPs can be accessed; the IOP with which you are currently 
communicating; the memory target; the state of the debuggers, in which a minus sign 
( -) indicates that the debugger is loaded in that particular IOP, a plus sign (+) 
indicates that the debugger is loaded and entered, and no symbol indicates that the 
debugger is not loaded; and any breakpoints set. 

Prints the last expression entries from the trace table of the current IOP. If you do not 
specify expression, the whole table will be printed. The table is printed in reverse 
chronological order, with the newest entries first. 



Unsets the breakpoint for addressl or all addresses. You must enter either addressl 
or a 1 1 ; there is no default. This command is valid only when you are in the debugger 
on the IOS-E. 

Sets the number of words to display when using the memory display commands 
{address, +, -, +n, -n, . +n, >, <), and the number of registers to display when using 
the register command. If you do not specify expression, the default is 1. This is 
equivalent to setting the WORDS variable as follows: WORDS ^.expression. 

Continues program execution from debugger. 
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xp address Displays 1 6 words of memory as a CPU exchange package. You cannot use this 

command while you are looking at local memory; if you try to do so, you will get an 
error message. 

# comment Specifies a comment. Any text following a # is ignored up to the next new-line 

character. This allows comments to be added to script files. 

VARIABLES 

Variables in e crash script files or in standard input lines must be in the following format: 

name ^expression 



A variable name must begin with an alphabetic letter or underscore and must contain a unique sequence of 
letters, digits, or underscores; the name can consist of 1 9 or fewer characters. You cannot use a variable name 
that is the same as an ecrash built-in command name, or the same as a command name listed in the "FLOW 
CONTROL" or "I/O REDIRECTION" section, ecrash is case-sensitive; therefore both lower and LOWER, 
for example, are unique. 

The value associated with a variable must follow an equal sign (=) and must consist of an octal (preceded by 
0), decimal, or hexadecimal (preceded by Ox) integer. 

A variable is declared when you assign an initial value to it, as in the following example: 
c0-i0-> LOWER=0100 



If you refer to a variable that has not been declared, ecrash will issue an error. 

The following variables are predeclared; you can change the definitions of these variables by redeclaring 
them: 

Variable Definition 

CLUSTER Specifies the cluster to be examined with ecrash. The initial value is 0. 

IOP Specifies the IOP to be examined ecrash. The initial value is 0 . 

WORDS Specifies the number of words of memory displayed by the memory formatting commands . 

The initial value is 8 . 

BASE Specifies the base value used when referencing registers. The initial value is 0 . 

The following predeclared variables cannot be modified: 
Variable Definition 

OFFL INE Logically true if ecrash is running in off-line mode (that is, accessing a dump file). 

ONL I NE Logically true ifecrashis running in on-line mode (that is, accessing a live system) . 

EXPRESSIONS AND REGISTERS 

The ecrash program supports the following operators; jc and y may be variables, numbers, registers, or 
other expressions, listed in order of precedence: 

Operator Description 

(...) Groups expressions 

-x Specifies a negative (twos complement) value of jc 

~x Specifies the ones complement of jc 

@x Specifies the value at address jc in the currently selected memory target 
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! x Specifies the logical inverse of x 

x*y Specifies jc multiplied by y 

x/y Specifies jc divided by y (integer division) 

x%y Specifies x modulus y (remainder) 

x+y Specifies jc plus y 

x-y Specifies x minus y 

jc«y Specifies jc left shifted y bits (zero filled) 

jc»y Specifies jc right shifted y bits (zero filled) 

jc<y Specifies a value of true if x is less than y 

jc< =y Specifies a value of true if jc is less than or equal to y 

jc>y Specifies a value of true if x is greater than y 

jc>=y Specifies a value of true if x is greater than or equal to y 

x= =y Specifies a value of true if x is equal to y 

jc ! =y Specifies a value of true is x is not equal to y 

jc&y Specifies bitwise and of jc and y 

jc"y Specifies bitwise xor of jc and y 

x\y Specifies bitwise or of x and y 

jc&&y Specifies logical and of jc and y 

jc||y Specifies logical or of jc and y 

Specifies the current address in the currently selected memory target 



The ecrash program lets you use the value of registers inside expressions. They are referenced as 
follows: 

Register Description 

' a ' Specifies the A register. You must enter the single quotation marks. 

' b ' Specifies the B register. You must enter the single quotation marks. 

' c ' Specifies the C register. You must enter the single quotation marks. 

' e ' Specifies the E pointer. You must enter the single quotation marks. 

'intr' Specifies the interrupt flag. You must enter the single quotation marks. 

' bas e ' Specifies the base register. You must enter the single quotation marks. 

' e [ n] ' Specifies exit stack entry n (n may be an expression). Note: you must literally enter the single 
quotation marks and brackets as well as value for n; the brackets in this case do not indicate 
optional information. 

'f[n]' Specifies the flags for channel n (n may be an expression). Note: you must literally enter 

single quotation marks and the brackets as well as value for n; the brackets in this case do not 
indicate optional information. 

' r [ n] ' Specifies register n, after applying BASE (n may be an expression). Note: you must literally 
enter single quotation marks and the brackets as well as value for n; the brackets in this case do 
not indicate optional information. 

' p ' Specifies the instruction pointer. You must enter the single quotation marks. 



SR-3077 2.0 



51 



Cray Research, Inc. 



ECRASH(8) 



ECRASH(8) 



FLOW CONTROL 

The ecrash program supports constructions that alter the flow of execution, depending upon evaluation 
of conditions. The supported constructions are as follows: 

i f ( expression ) statement 

r 

If expression is true, (that is, it evaluates as nonzero) statement will be executed; if 
expression is false (that is, it evaluates to zero), continue. 

if {expression) statement 1 else statement2 

If expression is true (that is, it evaluates as nonzero), statement! will be executed; if 
expression is false (that is, it evaluates to zero), statement! will be executed. Because to the 
nature of the parser, else must be on the same line as the end of statement 1 ; for example, if 
you enclose the statement block in braces, else must be on the same line as the closing 
brace for that statement. 

wh i 1 e ( expression ) statement 

As long as expression is true (that is, as long as it evaluates as nonzero), statement is 
executed. The break and continue commands allow program flow to be modified 
from within the loop (break exits it, con t inue jumps to the evaluation). 

for ( expression! ; expression! ; expressions ) statement 

expression! 

while {expression!) { 
statement 
expression3 

} 

These constructions are equivalent. Any or all of the expressions may be absent, in which 
case they evaluate to true. In both constructions, expression! is evaluated once; then, as 
long as expression! is true, statement is executed and expressions is evaluated. 

Example: 

for (i=0; i<3; i=l+i) status 

I/O REDIRECTION 

The ecrash command allows you to include other source files as input and to redirect the output to files, 
programs, or pipes, as follows, statement can be a collection of one or more ecrash commands, and the 
quotation marks are required: 

inc lude "file " Reads input from the specified file until the end-of-file character; you must 

enclose file in quotation marks. If the file cannot be opened, ecrash will issue 
an error message. You can have up to 10 nested include statements. 
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Redirects the output of statement to the specified file, restoring the output to 
standard output after execution of the statement has completed; you must enclose 
file in quotation marks. If file does not already exist, it will be created. If file 
already exists, its contents will be overwritten with the output from statement 
unless the noclobber environment variable is set; if noclobber is set, the 
existing file will not be overwritten and you will get a warning message. 

Appends the output of statement to the specified file, restoring the output to 
standard output after execution of the statement has completed; you must enclose 
file in quotation marks. If file does not already exist, it will be created. If file 
already exists, the output is added to the end of the file; the previous contents will 
not be overwritten. 

statement \ " unixcommand " 

Pipes the output of statement to the specified SunOS command (which may itself 
be a pipeline), restoring the output to standard output after execution of the 
statement has completed; you must enclose unixcommand in quotation marks. 
The command is executed in a subshell, so normal shell expansion can take place. 

> "file " Redirects the output of ecrash to the specified file until you end the ecrash 

session or enter > by itself; you must enclose file in quotation marks. If file does 
not already exist, it will be created. If file already exists, its contents will be 
overwritten with the output from statement unless the noclobber environment 
variable is set; if noclobber is set, the existing file will not be overwritten and 
you will get a warning message. 

» "file " Appends the output of ecrash to the specified file until you end the ecrash 

session or enter > by itself; you must enclose file in quotation marks. If file does 
not already exist, it will be created. If file already exists, the output will be added 
to the end of the file; the previous contents will not be overwritten. 

| " unixcommand" Permanently pipes the output of ecrash to the specified OWS-E or Sun OS 
command, which may itself be a pipeline; you must enclose unixcommand in 
quotation marks. The command is executed in a subshell, so normal shell 
expansion can take place. To send output back to standard input, see > (below). 

> Restores the output of ecrash to standard output. 

NOTES 

The dump file format has changed. You can use the conv(8) program to convert old dumps to the new 
format. 

Built-in commands may not be abbreviated. 



statement > "file " 



statement » "file" 
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EXAMPLES 

The following examples show the declaration of a variable, an ecrash session using a dump file, an 
interactive session on a running system, the redirection of output, a search for strings, paging through a 
dump image, and displaying status in on-line mode. 

Example 1: Using Variables 

This example shows how you can use variables to specify ranges in an on-line ecrash session; what you 
type in is shown in bold: 

cO-iO-> LOWER=0100 
cO-iO-> UPPER=0200 

cO-iO-> for (i = LOWER; i < UPPER; i = i + 1) { 

if (@i mm 014) { 

od @(i+l) ,1, words 

} 

} 

c0-i0-> 

Example 2: Examining a Dump File 

The following shows an example examination of a dump file. Comments are shown in roman font and 
preceded by a number sign (#). 
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machine$ ecrash -f newdump 

cO-iO-> status 
ecrash status: 

Processor: cluster 0, iop 0 

Memory : local 



Dump information 
Mainframe 
Date 
Reason 
Filename 



1601 

02/16/1992 Time: 13:02 

IOP dumped by user 
dmp. 02161302 



Cluster 



Cluster 



Cluster 



Cluster 



Cluster 



Cluster 



Cluster 



Cluster 



Cluster 



Cluster 



0, iop 0 : 

registers 
■local memory 

0, iop 1 : 

registers 
■local memory 

0, iop 2 : 

registers 
•local memory 

0, iop 3 : 
■registers 

local memory 

0, iop 4 : 
•registers 
local memory 

1, iop 0 : 
■registers 
■local memory 

1, iop 1 : 
•registers 
•local memory 

1, iop 2 : 
registers 
■local memory 

1, iop 3 : 
■registers 
local memory 

1, iop 4 : 
•registers 
■local memory 



(0000000 - 0177777) 



(0000000 - 0177777 



(0000000 - 0177777) 



(0000000 - 0177777 



(0000000 - 0177777) 



(0000000 - 0177777 



(0000000 - 0177777) 



(0000000 - 0177777) 



(0000000 



0177777 



(0000000 - 0177777) 
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#Print the last five trace entries in each IOP: 



cO-iO-> for (IOP = 0; IOP <= 4; IOP = IOP+1) { 
calc IOP 
trace 5 

} 



Oct 



Oct - 1 



0 Hex - 0 Signed dec - 
rtc 000000 054257 
000000 

177000 000000 
177000 000000 
000002 
Hex - 1 Signed dec - 
rtc 000000 000002 



Oct 



Oct 



Oct - 4 



0125 
0124 
0123 
0122 



0 Unsigned dec - 0 

000002 000000 

1 Unsigned dec - 1 



0173 
0172 
0002 
0002 
Hex - 

rtc 
0411 
0410 
0411 
0407 
Hex - 

rtc 
0177 
0176 
0002 
0002 
Hex - 

rtc 
0005 
0003 

rtc 
0003 



000011 
000010 

2 Signed dec - 
000000 056327 
056326 074172 
056326 066304 
056326 066077 
056326 064564 

3 Signed dec - 
000000 000002 
052771 
037005 
000011 
000010 

4 Signed dec - 
000000 066522 
000010 000000 
000030 000017 
000000 063515 
000034 000600 



2 Unsigned dec - 2 

120110 010015 000000 

120110 140000 000000 000000 

120110 140000 000000 

120110 120110 000002 000000 000000 

3 Unsigned dec - 3 



4 Unsigned dec - 4 

000002 177777 
000130 000004 000004 

000144 000053 000015 



# Examine low memory of IOP 0: 

c0-i5-> processor 0 
c0-i0.-> format parcel 

c0-i0-> local 
c0-i0-> words 5 
c0-i0-> 0 

000000 010000 024000 075000 006777 062145 
000010 000000 000000 000000 000000 000000 
000020 064141 066164 000000 000000 
c0-i0-> <new-llne> 

000020 072151 
000030 072162 060543 062400 000000 175764 
000040 071565 061000 021762 000000 067157 



061165 063400 000000 ..(. z ... debug .. . 

140561 000000 000000 q. . . . 

halt . . . . 

061553 000001 163322 tick.... 

002000 000000 000000 trace 

026543 070165 000000 sub . # . . . no-cpu . . 
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# Display the registers: 

cO-iO-> register 
Registers (BASE = 0000) : 

0000 000000 004002 004062 000000 000000 

# Use the built-in calculator to evaluate an octal value, shifted right by four places: 

c0-i0-> calc 031056 >> 4 

Oct - 1442 Hex - 322 Signed dec - 802 Unsigned dec - 802 

# Locate the clock eyecatcher in low memory, using the SunOS gr ep(l) command: 

c0-i0-> od 0,200, word | "grep tick" 

000000020 0641413307200000000000 07215130665400003 63322 halt .... tick ... . 
c0-i0-> od 0,200 | "grep tick" 

0x000010 6861 6c74 0000 0000 7469 636b 0001 e6d2 halt .... tick ... . 

# Evaluate the result of using AND to compare the contents of local memory location 0x10 with Oxff: 

c0-i0-> calc @0xl0 & Oxff 

Oct - 141 Hex - 61 Signed dec - 97 Unsigned dec - 97 

# Exit with an exit code equal to the contents of local memory location Ox 10 (only the lower 8 bits are 
significant): 

c0-i0-> quit @0xl0 

# Show that the exit code was indeed 97 (decimal): 

machine$ echo $? 
97 

machine$ 
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Example 3: Examining a Running System 

The commands used in the first example are also available when ecrash is used to examine a running 
system. However, many of the following commands are valid only when you are in the debugger (as 
previously noted). 

machine% ecrash 

cO-iO-> debug on 
cO-iO-> a 

A register 163116 
cO-iO-> e 

E pointer 000001 
c0-i0-> e[2] 
Exit Stack : 

000 113663 105360 121443 107541 010162 113663 

010 000000 000000 

c0-i0-> flags 
Channel flags: 



chOO 


= NOT 


busy - 


- NOT 


done 


chOl 


= NOT 


busy - 


- NOT 


done 


ch02 


= NOT 


busy - 




done 


ch03 


= NOT 


busy - 


- NOT 


done 


ch04 




busy - 




done 


ch0 5 


= NOT 


busy - 


- NOT 


done 


ch06 


= NOT 


busy - 


- NOT 


done 


ch07 


= NOT 


busy - 


- NOT 


done 


chlO 


= NOT 


busy - 


- NOT 


done 


chll 


= NOT 


busy - 


- NOT 


done 


chl2 


= NOT 


busy - 


- NOT 


done 


chl3 


= NOT 


busy - 


- NOT 


done 


chl4 


= NOT 


busy - 


- NOT 


done 


chl5 


= NOT 


busy - 


- NOT 


done 


chl6 


= NOT 


busy - 


- NOT 


done 


chl7 


= NOT 


busy - 


- NOT 


done 


ch20 


= NOT 


busy - 


- NOT 


done 


ch21 


= NOT 


busy - 


- NOT 


done 


ch22 


= NOT 


busy - 




done 


ch2 3 


= NOT 


busy - 


- NOT 


done 


ch24 


= NOT 


busy - 


- NOT 


done 


ch2 5 


= NOT 


busy - 


- NOT 


done 


ch2 6 


= NOT 


busy - 


- NOT 


done 


ch27 


= NOT 


busy - 


- NOT 


done 


ch30 


= NOT 


busy - 


- NOT 


done 


ch31 


= NOT 


busy - 


- NOT 


done 


ch32 


= NOT 


busy - 


- NOT 


done 


ch3 3 


= NOT 


busy - 


- NOT 


done 


ch34 


= NOT 


busy - 


- NOT 


done 


ch3 5 


= NOT 


busy - 


- NOT 


done 


ch3 6 


= NOT 


busy - 


- NOT 


done 


ch37 


= NOT 


busy - 


- NOT 


done 



c0-i0-> issue 30 

A register returned = 0, busy = 1, done = 0 

c0-i0-> set 0 

c0-i0-> set 100 

c0-i0-> x 

c0-i0-> unset 100 

c0-i0-> unset 0 

c0-i0-> quit 

machine% 
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Example 4: Redirecting Output 

As discussed earlier, you can redirect ecrash command output, as you do on a UNIX command line. For 
example, the following will store the first 200 parcels of the dump image in a file named image: 



od 0,200 > "image" 



Example 5: Searching for Strings 

You can search for strings with grep(l). For example, the following command line searches for the ASCII 
string halt: 



od 0,0177777 | "grep halt 



Example 6: Paging through a Dump Image 

You can also use the SunOS more(l) command. For example, the following lets you page through the 
dump image by piping the od output to more: 



od 0, 0177777 | "more 



Example 7: Displaying Status in On-line Mode 

The following example shows the status command in on-line mode. What the user enters is shown in bold: 



owsl60 0% ecrash 
c0-i0-> status 
ecrash status : 

Processor: cluster 0, iop 0 

Memory : local 



Available IOPs : 

Cluster 0: iops 0 1-2+3 4- 
Cluster 1: iops 0 12 3 4 



Key : - Debugger loaded 

+ Debugger loaded & entered 

Breakpoints: NONE 
c0-i0-> 

This example shows that the debugger is not loaded for IOPs 0 and 3 in cluster 0 nor for any of the IOPs in 
cluster 1 , that it is loaded for IOPs 1 and 4 of cluster 0, and that it is loaded and entered for IOP 2 of cluster 0. 

FILES 

/etc/owsepermf ile Permissions file that contains a list of accounts and the commands 

they are allowed to access 

$HOME/ . ecrashrc ecrash resource file containing ecrash commands to be executed 

upon invocation of ecrash 
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SEE ALSO 

owsepermf i le(5) for information about the default OWS-E permission file 

conv(8) for information about converting files from the old edump file format to the new file format 

edump(8) for information about dumping the IOS-E to the OWS-E 

mf dump(8) for information about generating a CPU dump 

I/O Subsystem Model E (IOS-E) Guide, publication SD-2107, for additional information about and examples 
of ecrash. (This document contains information private to Cray Research, Inc. It can be distributed to 
non-CRI personnel only with approval of the appropriate Cray Research manager.) 
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NAME 

ediag - Boots deadstart diagnostic tests (dsdiag or cleario) into one or more specified IOPs 
SYNOPSIS 

/home/foca/Zzosf/cri/smarte/bin/ediag [-d] [-D] [-F] [-h] [-M] [-v] cluster : iop : file 
[cluster : iop :file] ... 

/home / localhost/ cri / smarte /bin/ ediag [-d] [-D] [-F] [-h] [-M] [-v] -c cluster -i iop 
-f deadstart 

DESCRIPTION 

The ediag command boots deadstart diagnostic tests into a specified IOP. It updates the heartbeat table to 
show that the IOP is no longer running IOP system code. If the diagnostic test fails, error information will 
be reported, ediag is usually run by the eboot(8) command. Normally, ediag asks for confirmation 
before taking any action. You can force ediag not to ask for confirmation by specifying the -F option. 

The ediag command will notify SMARTE, which is running on the MWS-E, if a deadstart diagnostic test 
fails. 

You must specify either cluster -.iop -.file or the -c and -i options. The arguments to ediag are as 
follows: 

cluster : iop -.file [cluster : iop -.file] ... 

Specifies the cluster and IOP that should have the specified diagnostic binary file booted 
in; at least one set of cluster : iop -.file must be specified. You may specify more than 
one set of cluster : iop -.file if you separate the sets with white space. 

The range of valid values for cluster consists of integers from 0 through 15, depending 
upon the hardware configuration at your site, cluster may be a single integer, a list of 
integers separated by commas, or a range of integers separated by a hyphen. 

The range of valid values for iop are integers in the range 0 through 4, depending upon 
the hardware configuration at your site, iop may be a single integer, a list of integers 
separated by commas, or a range of integers separated by a hyphen. 

The specified file may begin with a tilde character (~), which is expanded to the home 
directory of the login name that follows the tilde or, if not followed by a login name, to 
your home directory. 

For examples of legal syntax, see the "EXAMPLES" section. 



-d Sets debug mode in the diagnostic program. 

-D Sets debug mode in the ediag program and sends the output to standard error. 

-F Forces ediag not to ask for user confirmation before booting the deadstart diagnostic 

test and suppresses most informative messages. (Error messages will still appear.) 

-h Sets headerless load mode. Use this option when the file you specify does not have a 

header. If you do not specify this option, the eboot program strips the 64-byte 
segldr(l) header from the binary file; if there is no header, information will be lost. 
(By default, IOP binaries include a 64-byte a . out header.) 

-M Issues the cluster master clear function. If booting the MUXIOP, a cluster master clear is 

issued to all IOPs in the cluster. CAUTION: this stops any other IOPs running in that 
i cluster; therefore, you should specify the MUXIOP before other clusters. 

-v Sets verbose mode, which forces ediag to print informative messages to standard error. 
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Specifies the cluster in which to run the diagnostic test. The range of valid cluster 
numbers depends on the number of clusters in the IOS-E. If you specify this option, you 
must also specify -i and -f. 

Specifies the number of the IOP into which the diagnostic test is to be booted. If you 
specify this option, you must also specify -c and -f . iop can be an integer in the range 
0 through 4 (4 indicates theMUXIOP; 0 through 3 indicate ElOPs). 

Specifies the file name of the deadstart diagnostic test (specify the complete path name if 
the file is not in the current directory). If you specify this option, you must also specify 
-cand -i. deadstart is defined by IOSDPATH in /etc/conf igf ile and can be 
one of the following: 

/home/foca/Zzort/cri/os/ios/dsdiag (the default) 
/home /focaZ/wsf/cri/os/ios/ cleario 

CONFIGURATION FILE PARAMETERS 

The ediag command reads the following parameters from /etc/conf igf ile: 
IOSCPATH Defines the path name of the I/O clear diagnostic test. Default: 

/home //oca/fttfjt/cri /os/ios/ clear io 
IOSDPATH Defines the path name of the IOP deadstart diagnostic test. Default: 

/home/foca/ftostf/cri/os/ios/dsdiag 

EXAMPLES 

All of the following example formats are legal: 

ediag 0:1: /home/owse/cri/os/ios/dsdiag 

ediag 0 : 1 : ~cri/os/ios/boot . 1 0 : 2 : ~cri/os/ios/dsdiag . 2 

ediag 0,5:0: /home/owse/cri/os/ios/dsdiag 

ediag 1-15:0,4: ~cri/os/ios/dsdiag 

If you wanted to use cluster l,lOP 1 in debug mode, with the cleario deadstart diagnostic file, and in 
verbose mode, you could enter the following: 

ediag -c 1 -i 1 -d -f 'getconfig "IOSCPATH"' -v 

To boot a binary file named d s d i a g into IOPs 1 and 2 of cluster 0, enter the following : 

ediag 0:l,2:dsdiag 



-c cluster 



-i iop 



- f deadstart 



FILES 

/etc/conf igf ile 

/ home / localhost/ cr i / os / i o s / c 1 ear i o 
/home/toca/Zio^/cri/os/ios/dsdiag 



Default OWS-E configuration file 
Default cleario deadstart diagnostic file 
Default dsdiag deadstart diagnostic file 
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SEE ALSO 

eboot(8) for information about booting the IOS-E 

OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for information about 

/etc/conf igf ile 

UNICOS 6.E Early Release Software On-line Diagnostic Technical Note, publication SPN-1022. (This 
technical note is Cray Research Proprietary; dissemination of this information to non-CRl personnel 
requires approval from the appropriate vice president and a nondisclosure agreement. Export of technical 
information in this category may require a Letter of Assurance.) 
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NAME 

edump - Dumps IOS-E IOP local memory images to the OWS-E 
SYNOPSIS 

/ 'home / localhost /cxi/hin/ edump [-a] [-D] [-e] [-f pathname] [-F] [-p path] [-q] [-v] 
cluster :iop[: reason] [cluster :iop[: reason] ] ... 

/home /localhost /cri /bin /edump [-a] [-D] [-e] [-f pathname] [-F] [-p path] [-q] [-v] 
-c cluster -i iop [reason] 

DESCRIPTION 

The edump command dumps multiple IOPs of multiple clusters to the OWS-E. edump creates a dump 
image that can be processed with other utilities, such as ecrash(8). After edump is used, the IOPs that 
have been dumped must be restarted with the eboot(8) command or one of the boot scripts. Processors 
will usually be dumped with edump when they are hung. 

CAUTION: If you execute edump on a running system, the system will crash. Normally, 
edump asks for confirmation before taking any action. You can force edump not to ask for 
confirmation by specifying the -F option. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 

You must specify either cluster :iop[: reason] or the -c and - i options. The arguments to the edump 
command are as follows: 

cluster : iop[ : reason] [cluster : iop[ : reason]] ... 

Specifies the cluster and IOP that should be dumped; at least one set of cluster and iop 
must be specified, and they must be separated by a colon. You may specify more than 
one set of cluster : iop[ : reason] if you separate them with white space. 

The range of valid values for cluster consists of integers from 0 through 15, depending 
upon the hardware configuration at you site, cluster may be a single integer, a list of 
integers separated by commas, or a range of integers separated by a hyphen. 

The range of valid values for iop are integers in the range 0 through 4, depending upon 
the hardware configuration at your site, iop may be a single integer, a list of integers 
separated by commas, or a range of integers separated by a hyphen. 

If reason is specified, it must be preceded by a colon; quotation marks are required if the 
reason contains white space, reason is truncated after 79 characters, not including 
quotation marks (a longer reason will not cause an error, but the 80th and succeeding 
characters will not be used). When you specify more than one reason, only the first one 
encountered is used. If you do not specify reason, the string "IOP dumped by 
user" will be used. 

The following formats are all legal: 

edump 0 : 1 

edump 0 , 5 : 0 :" system is hung" 
edump 0:1 1-15 : 0 , 4 : "hung system" 

- a Specifies that all memory types of the selected IOP are to be dumped; that is, local memory, 

register memory, and all four channel buffers. (There are no channel buffers on the 
MUXIOPs.) This will result in large dump files because the channel buffers for each IOP are 
2 Mbytes . The default is to dump 64 Kparcels of local memory and all registers. 
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-D 
-e 



- f pathname 



-p path 



-q 



-c cluster 



nop 



reason 



Sets the debug mode in the edump program and sends the output to standard error. 

Echoes the file name of the resulting dump file to standard output. This option is useful in 
work with shell scripts ; it is inadvisable to use the - v and - q options with - e . 

Specifies the full path name of the I op save program that gets the internal registers and 
channel buffers. The default path name is /home/ localhost / cri / os / ios / iopsave. 

Forces edump not to ask for confirmation before halting the IOP and suppresses most 
informative messages. (Error messages will still appear.) 

Specifies the path name of the directory in which the dump image should reside. The dump 
image has the name dmp . mmddhhmm, in which mmddhhmm specifies the month, date, 
hour, and minute; for example, if a dump image were created at 4:43 P.M. on February 2, the 
file containing it would be named dmp .02021643. If you do not enter the -p option, the 
default directory will be specified by the default I dumpd I R parameter 
in/etc/configfile;at release, this parameter is set to / va r / dump s . If two or more 
dumps are taken within the same minute, the letters a, b, and so on, are added to the file 
names to make them unique. See EXAMPLES . 

(query) Asks you for memory types to dump. The default values are for all of local memory 
and all internal registers. The - q option allows users to get a smaller range of memory 
and/or channel buffer memory. The default is to dump 64 Kparcels of local memory and all 
registers. 

Sets verbose mode. This option forces edump to print informative messages to standard 
output. 

Specifies the cluster that should be dumped. The range of valid cluster numbers is an 
integer from 0 through 15, depending upon the number of clusters in your IOS -E. If you 
specify this option, you must also specify - i . 

Specifies the number of the IOP to be dumped, iop can be one or more integers in the range 
0 through 4 (separated by commas), the word mux, or the word a 1 1 . a 1 1 dumps the 
complete cluster; mux is the same as 4 . If you specify this option, you must also specify - c . 

Specifies the reason for the dump; for example, "Halt 24". (Although the quotation 
marks are not always required, you should use them to avoid problems with special 
characters.) The reason given may be up to 79 characters long. Although it is notrequired, 
adding this explanation in the command line is especially useful if you intend to use scripts 
for autoboots or autodumps. Entering a reason also helps to distinguish dumps as dump 
files start to accumulate. If you do not specify a reason, the string " I O P dump e d by 
user" will be used by default. 



CAUTION 

If you execute edump on a running system, the system will crash. 

NOTE 

The format for the name of a dump image file was dmp . mmdd . hhmm, but with OWS-E 2.0 it is now 
dmp . mmddhhmm to avoid truncation problems on some systems. Also, the default for -p is now 

/var/dumps. 
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EXAMPLES 

The following examples show dumping multiple IOPs and specifying the dump-image directory. 

Example 1: Dumping Multiple IOPs 

The following example dumps IOP 1 and IOP 3 from IOS 0, cluster 2, and prints informative messages to 
standard error: 

edump -v 2 : 1 , 3 : " system panic" 

Example 2: Dumping a Range of IOPs and Clusters 

The following example dumps IOP 1, IOP 2, and IOP 3 from IOS 0, clusters 2 through 6, and prints 
informative messages to standard error: 

edump -v 2-6 : 1-3 :" system panic" 

Example 3: Dumping a Group of IOPs and Clusters 

The following example dumps the following IOPs from IOS 0: IOP 1, IOP 2, and IOP 3 from cluster 2; IOP 0 
from cluster 3; and all of the IOPs from clusters 4 and 5. The reason used is "system panic" because it 
is the first reason encountered (the second value for reason is ignored): 

edump 2 : 1-3 : "system panic" 3:0 4 , 5 : 0-4 : "halt code 32" 

Example 4: Specifying the Directory 

The following example specifies that the dump image should be placed in /var/temp/dumpdir and 
creates the file /var/temp/dumpdir/dmp .08160623: 

edump -c 0 -i 0 -p /var/temp/dumpdir "Halt 24" 

If you took another dump in less than 1 minute, the second file would be named 

/var/temp/dumpdir/dmp . 08160623 .a. 

Example 5: edump in a Shell Script 

The following example shows a script that dumps all of the IOPs from clusters 0 and 1 in IOS 0, using the 
reason of "system panic" and without asking for confirmation. If the script does not execute properly, 
you are given the message that the dump failed; if it executes properly, you are given the name of the dump 
file: 

#!/bin/sh 

#Dump all IOPs in clusters 0 and 1 

FNAME= ' edump -e -F 0 , 1 : 0-4 :" system panic"' 

if [ $? != 0 ] 

then 

echo "Dump of IOS failed" 
exit 

fi 

echo "Dump file name is $FNAME" 

RETURN VALUES 

The edump command returns a value of 0 when it completes successfully. 
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CONFIGURATION FILE PARAMETERS 

The edump command reads the following parameters from /etc/conf igf ile: 



DEFAULTIDUMPDIR 



IOPLOG 



I OPS AVE 



SERIALNUMBER 



ENVIRONMENT VARIABLES 



OWSECONFIG 



Defines the default dump directory path in which the dump shell script is 
created. Default: 

/var/ dumps 
Defines the path name of the IOP log file. Default: 

/var / logs / ioplog 

Defines the path name of a temporary file used by the edump(8) utility 
during its processing. Default: 

/home/ HOSTNAME /cr i /os / ios / iopsave 

Defines the serial number of the CRI mainframe to which the OWS-E is 
attached. Default: 

SERIALNUMBER token (replaced during installation) 



Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 



FILES 



/etc/conf igf ile Default OWS-E configuration file 

/etc/owsepermf ile Permissions file that contains a list of accounts and what 

commands they are allowed to access 

/home /localhost/cr i /os / ios / iopsave Default path name of the IOPSAVE program 

/ var / dump s Default dump directory 



SEE ALSO 



conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about / e t c / con f i g f i 1 e 

owsepermf ile(5) for information about the default OWS-E permission file 

conv(8) for information on how to convert files from old edump file format into new edump file format 
eboot(8) for information on how to reboot the IOS-E from the OWS-E after a dump is taken 
ecrash(8) for information about dump processing 

dumpsys(8) or mf dump(8) for information about generating a mainframe dump 
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NAME 

ehal t - Halts one or more IOPs from the OWS-E 
SYNOPSIS 

/home//c>ca/A<9^/cri/bin/ehalt [-C] [-F] [-h code] [-M] [-v] cluster: iop[: reason] 
[cluster : iop[ : reason]] ... 

home / localhost/ cri /bin/ ehalt [-C] [-F] [-h code] [-M] [-v] -c cluster -i iop 
DESCRIPTION 

The ehalt command stops an IOP from the OWS-E. ehalt enters a halt code (operator stop) into IOP 
local memory and issues a master clear function to stop the processor. 

Normally, ehalt asks for confirmation before taking any action. You can force ehalt not to ask for 
confirmation by specifying the -F option. 

If you execute the ehalt command directly, it will usually be because you want to get a dump image with 
the edump(8) command. When you have the dump image, you will probably want to reboot the IOP with 
the eboot (8) or boot sys(8) commands. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 

You must specify either cluster : iop[ : reason] or the -c and - i options. The arguments to the ehalt 
command are as follows: 

cluster : iop[ : reason] [cluster : iop] [ : reason] ] ... 

Specifies the cluster and IOP that should be halted; at least one set of cluster and iop 
must be specified, and they must be separated by a colon. You may specify more than 
one set of cluster : iop[ : reason] if you separate them with white space. The 
implementation for reason is currently deferred; it will be used as input to a system 
status table in a future release. 

The range of valid values for cluster consists of integers from 0 through 15, depending 
upon the hardware configuration at you site, cluster may be a single integer, a list of 
integers separated by commas, or a range of integers separated by a hyphen. 

The range of valid values for iop consists of integers in the range 0 through 4, 
depending upon the hardware configuration at your site, iop may be a single integer, a 
list of integers separated by commas, or a range of integers separated by a hyphen. 

FUTURE IMPLEMENTATION: If reason is specified, it must be preceded by a colon 
and, if it contains any white space, it must be enclosed in quotation marks. If you do not 
specify reason, toe string "IOP halted by user" will be used unless the -C 
option is specified, in which case the default reason will be " IOP halted by CPU " . 

All of the following formats are legal: 

ehalt 0:1 

ehalt 0 , 5 : 0 :" system is hung" 
ehalt 1-15 : 0, 4 : "hung system" 0:1 

- C Specifies that the halt was requested by the mainframe. You will not normally invoke this 

option manually. 



SR-3077 2.0 



68 



Cray Research, Inc. 



EHALT(8) 



EHALT(8) 



- F Forces eha 1 1 not to ask for confirmation before halting the IOP and suppresses most 

informative messages. (Error messages will still appear.) 

-h code Specifies the halt code. 

-M Master clears and halts the cluster. Use this option only when you are halting the MUXIOP. 

-v Sets verbose mode. This option forces eha 1 1 to print informative messages to standard 

error. 

- c cluster Specifies the cluster in which the IOP resides. The range of valid cluster numbers depends 

on the number of clusters in the IOS-E. If you specify this option, you must also specify - i . 

- i iop Specifies the number of the IOP to be stopped, iop can be an integer in the range 0 through 4 

(4 indicates the MUXIOP). If you specify this option, you must also specify - c . 



BUGS 



The use of the reason argument is deferred until a future release. 

EXAMPLES 

The following example halts IOP 3 in cluster 0: 

ehalt -c 0 -i 3 

The following example halts every IOP on the system: 

ehalt 'estat -a' 

FILES 

/etc/owsepermf ile Permissions file that contains a list of accounts and the 

commands they are allowed to access 



SEE ALSO 



owsepermf i le(5) for information about the default OWS-E permission file 
eboot(8) for information about booting the IOS-E 
edump(8) for information about dumping the IOS-E 
estat(8) for information about displaying the IOP status 
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NAME 

emon - Restarts the IOS-E error-logging, heartbeat, SMARTE, and CPU monitors 

SYNOPSIS 

/ home / localhost/ cri/bin / emon 

DESCRIPTION 

The emon command restarts the error logging routine, err logd(8), the IOS-E halt and hang monitor, 
hbeat(8), cpud(8), smdemon(8) SMARTE monitor, and rcpud(8) "remote CPU daemon" CPU monitor. 
Use this command to restart the various IOS-E monitoring processes on the OWS-E if they are down. 

If you enter emon when the processes are already running, no damage will be done and you will not get an 
error message. You will get an error message only if emon is unable to start one of the monitors. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 
ENVIRONMENT VARIABLES 

owseconfig Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 

FILES 

/etc/ ows ep e rm file Permissions file that contains a list of accounts and the commands they are 

allowed to access 



SEE ALSO 



owsepermf i le(5) for information about the default OWS-E permission file 
err logd(8) for information on the error-logging routine 
hbeat (8) for information on the IOS-E halt and hang monitor 
rcpud(8) for information on the CPU monitor 
smdemon(8) for information about the SMARTE monitor 
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NAME 

eping - Sends an echo packet to an IOP from the OWS-E 
SYNOPSIS 

/home / localhost/ cri /hin/ eping [-c cluster] [-i iop] [-1 length] [-n number] [-p start] 
[-m increment] [-t] [-W] 

DESCRIPTION 

The eping command sends echo packets from the OWS-E to an IOP to verify the service workstation 
interface (SWT) connection. An 8-bit data pattern is checked for accuracy upon packet return. 

The arguments to eping are as follows: 

-c cluster Specifies the cluster in which the IOP resides. The range of valid cluster numbers 

depends on the number of clusters in the IOS-E. The default is 0. 

- i iop Specifies the number of the IOP to which packets are to be sent, iop can be an integer in 

the range 0 through 4. The default is 0. 

- 1 length Specifies the packet length in parcels, length must be a positive integer: for service echo 

packets, length must be an even integer greater than or equal to 4 (64 is the maximum); 
for workstation interface (WIN) loopback transfers, the value must be an integer greater 
than or equal to 1 (64 is the maximum). The default is 4. 

-n number Specifies the number of echo packets to be sent, number must be a positive integer. The 
default is 1. 

-p start Specifies the initial byte. Each subsequent byte is incremented by the pattern increment 

specified by the -m option. The default is 1. 

-m increment Specifies the number value by which the pattern is incremented; the initial value is 

specified by the -p option. Each subsequent packet continues from where the previous 
one left off. The default is 1. 

- 1 Prints the amount of time (in milliseconds) that each packet required to complete a 

round trip. 

-W Specifies a loopback from the OWS-E to the WIN. 

MESSAGES 

If the connection is good, you will receive the following message: 
cluster jc iop y is alive. 

If the connection is bad, you will receive the following message: 

Packet n - pattern miscompare at byte jc - expected y - received z 



Permission to access this command is set in / e t c / ows epe rmf i 1 e by the system administrator. 
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CONFIGURATION FILE PARAMETERS 

The eping command reads the following parameter from /etc/conf igf ile: 
IOPLOG Defines the path name of the IOP log file. Default: 

/var/logs/ioplog 

EXAMPLES 

Example 1: In the following example, eping will send 20 packets to IOP 3 in cluster 1: 

owsl600$ eping -c 1 -i 3 -n 20 

cluster 1 iop 3 is alive. 
owsl600$ 

Example 2: In the following example, ep i ng will send 1 packet to IOP 0 in cluster 0. The pattern will start 
with 3 and be incremented by 2: 

eping -p 3 -m 2 

That is, the pattern will be as follows: 



| 3 | 5 | 7 | 9 |11 1 13 1 15 1 17 | <--Pattera 
|___|___|___|___|___|___|___|___| 

|0|1|2|3|4|5|6|7| <-Bytenumber 



FILES 

/etc/owsepermf ile Permissions file that contains a list of accounts and the 

commands they are allowed to access 

/etc/conf igf i le Default OWS-E configuration file 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

owsepermf i le(5) for information about the default OWS-E permission file 
hcon(8) and econ(8) for information about configuring the IOS-EMUXIOP channels 
peek(8) for information about examining various types of memory in a CRI system 
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NAME 

err logd - IOS-E hardware error-logging daemon 
SYNOPSIS 

• /home / localhost/ cri /bin/ err logd 
DESCRIPTION 

The err logd daemon receives error information from the IOS-E and logs it in the file specified by the 
ERRLOG parameter in /etc/conf igf ile. By default, this file is /var/logs/errlog. file. 

Every 60 seconds, err logd also reads MUXIOP errors out of IOS-E local memory for high-speed channels 
010-017, low-speed input channel 020, and low-speed output channel 021, and reads EIOP errors for 
channel-buffer channels 020 and 027, and low-speed input channel 022. These errors are recorded in 
circular buffers in the IOPs. If too many errors occur between reads of the buffer by err logd, some 
information will be lost, err logd logs a warning that specifies how many error reports were lost. 

The err logd command also sends all IOS channel errors to the SMARTE system running on the MWS-E 
maintenance workstation. 

CONFIGURATION FILE PARAMETERS 

The errlogd command reads the following parameters from /etc/conf igf ile: 
ERRLOG Defines the path name of the error log file. Default: 



/var/logs/errlog 



ENVIRONMENT VARIABLES 



OWSECONFIG 



Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 



FILES 



/var/logs/errlog 



/etc/conf igf ile 



Default OWS-E configuration 

Default hardware error log file as defined by ERRLOG in 
/etc/conf igf ile 



SEE ALSO 



conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

owsepermf i le(5) for information about the default OWS-E permission file 

emon(8) for information about restarting the IOS-E error logging, heartbeat, and CPU monitors 
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NAME 

est at - Checks IOP status 
SYNOPSIS 

/home/focaZ/zo^/cri/bin/estat [-a] [-c cluster] [-i iop] [-v] 
DESCRIPTION 

The estat command checks the status of the IOPs in a given cluster. The returned status indicates 
whether or not an IOP is running. The state of each IOP is determined from the Shared Memory table used 
by hbeat(8), the IOP heartbeat monitor. The default action of this command checks all possible IOPs in 
all possible clusters in the Shared Memory table. 

The arguments to estat are as follows: 

-a (abbreviated) Specifies abbreviated mode, which prints the output in the 

cluster : iop : string format used by various OWS-E commands. For an example, see 
EXAMPLES below. 

-c cluster Specifies the IOS-E cluster number. The range of valid cluster numbers depends on the 

number of clusters in the IOS-E. If no cluster is given, all clusters are checked. 

- i iop Specifies the number of the IOP to be checked, iop can be an integer in the range 0 

through 4 (4 indicates the MUXIOP). If no IOP number is given, all IOPs are checked. 

-v Sets verbose mode. This option forces estat to print informative messages to standard 

error. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 

NOTES 

The estat command checks for 16 clusters, even if your site has a different configuration. See 
EXAMPLES for a sample output. 
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EXAMPLES 

The following command line prints the status of all IOPs in all clusters 

estat 

If your site has 1 cluster and you execute estat, you could get the following output (user input is shown in 
bold): 



owsl600% estat 



-L1N.T \J . 


© S t clt 


iop 




cluster 0 


running 


XInJT \J • 


© S t clt 


iop 


i / 


cluster 0 


running 


INFO : 


estat 


iop 


2, 


cluster 0 


running 


INFO: 


estat 


iop 


3, 


cluster 0 


running 


INFO : 


estat 


iop 


4, 


cluster 0 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


1 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


2 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


3 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


4 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


5 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


6 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


7 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


8 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


9 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


10 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


11 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


12 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


13 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


14 


running 


INFO: 


estat 


no 


iop 


in 


cluster 


15 


running 



owsl600% 

To display this same information in abbreviated mode, use the -a option: 

owsl600% estat -a 
0:0-4 

The following command line prints the status of all IOPs in cluster 0: 

estat -cO 

The following command line prints the status of IOP 2 in cluster 6: 

estat -c6 -i2 



FILES 

/etc/owsepermf ile Permissions file that contains a list of accounts and the commands they are 

allowed to access 
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SEE ALSO 

owsepermf i le(5) for information about the default OWS-E permission file 
hbeat(8) and emon(8) for information about monitoring the IOS-E system 
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NAME 

f yadmin - Controls the f y driver 
SYNOPSIS 



/etc/fyadmin -b type [-a. file | -o file] [-z device] 
/etc/fyadmin -c [-a file \ -o file] [-z device] 
/etc/fyadmin -C mode [-a file \ -o file] [-z device] 
/etc/fyadmin -d display [-a file | -o file] [-z device] 
/etc/fyadmin -D binary [-a file | -o file] [-z device] 
/etc/fyadmin -e action [-a file | -o file] [-z device] 
/etc/fyadmin -r [-a. file \ -o file] [-z device] 
/etc/fyadmin -t type [-a file | -o file] [-z device] 



DESCRIPTION 



The f yadmin command allows you to reset the hardware boards and software drivers and to download 
operational firmware to the FEI-4. Most of the options will be used by the analyst only; the administrator 
will commonly use the following options: 

-r 

-D binary 
-b i 

The -b, -c, -c, -d, -D, -e, -r,and -t options are all mutually exclusive, as are the -a and -o options. 
Several argument values may be abbreviated to the first few characters; characters that are not required are 
shown in brackets. 

The arguments to f yadmin are as follows: 

-b type Sends a mailbox command, type can be one of the following: 

d[ i s ab 1 e_hbug] Disables the ability of the FEI-4 debugger (hbug) to 

communicate with the FEI-4 serial port, hbug is produced 
by Heurikon; seeFEI-4 Cray-VMEbus Front End Interface 
User's Manual, Heurikon Corporation, 1991. 

e [nab 1 e_hbug] Enables the ability of the FEI-4 debugger (hbug) to 

communicate with the FEI-4 serial port. 

i [nva 1 i da t e_r am] Invalidates the firmware flag in the FEI-4 but does not do 

anything to the code. If you are not sure what the 
downloaded code is, use this option to invalidate the 
present code, issue the - r option to reset the hardware and 
software, and then use the -D option to download known 
code. 

- c Clears out trace buffers in order to get a clean trace, and resets the pointer to the top of the 

trace. 
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-Cmode 



-d display 



Changes the FEI-4 low-speed (LOSP) channel mode of operation, mode can be one of the 
following: 

6_n[orma 1] Configures the LOSP channel in 6-Mbyte mode. 

6_i [n 1 oop] Configures the LOSP channel in 6-Mbyte mode, but enables 

internal hardware loopback (FEI-4 has an internal loopback path), 
using 6-Mbyte rules of operation. 

6_d[i r e c t ] Configures the LOSP channel so that it allows the ma i 1 box 

commands to read from or write to the channel directly; this 
disables the FEI-4 channel FIFOs. 



12_d[evice] 



12_c[hannel] 



12_i[nloop] 



Configures the LOSP channel in 1 2-Mbyte mode to operate as the 
device. This is the normal configuration of the FEI-4 when 
connected to a CRI IOS-E 1 2-Mbyte channel. 

Configures the LOSP channel in 1 2-Mbyte mode to operate as the 
channel. You will use this mode if, for example, your OWS-E is 
connected to another Sun Workstation, in which case one must be 
configured as the channel and the other must be configured as the 
device. 



Configures the LOSP channel in 1 2-Mbyte mode for internal 
loopback. The input side is configured as the device, and the 
output side is configured as the channel. 

1 2 _o_ i [n 1 oop] Configures the LOSP channel in 1 2-Mbyte mode for internal 
loopback. The input side is configured as the channel, and the 
output side is configured as the device. 

12_e[xloop] Configures the LOSP channel in 12-Mbyte mode for external 

loopback and sends a master clear signal so that if FOL-4 boxes 
are in the configuration, they will be reset to a known state. (Use 
of an FOL-4 box allows you to extend the LOSP channel to a 
distance greater than 50 feet.) The input side is configured as the 
device, and the output side is configured as the channel. 

12_o_e[xloop] Configures the LOSP channel in 12-Mbyte mode for external 
loopback and sends a master clear signal so that if FOL-4 boxes 
are in the configuration, they will be reset to a known state. (Use 
of an FOL-4 box allows you to extend the LOSP channel to a 
distance greater than 50 feet.) The input side is configured as the 
channel, and the output side is configured as the device. 

Displays the specified structure, display can be one of the following: 

t [race_control] Displays the f y driver's execution trace control structure, 

including the units ( 0 through 3 ) that are tracing events and the 
way the trace buffer is being used. 

q[descr iptor] Displays thestateof the unit's read-request, write-request, read- 
reply, and write-reply queues descriptor. 
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f w Displays the location at which the FEI-4 processor is executing, 

either random-access memory (RAM) or read-only memory 
(ROM), and the state of the firmware. The state is used to indicate 
what the firmware is doing. For an explanation of the various 
states, see the f 4_h . h header file. When the current state is 
ROM, one of the following is true: the system is waiting for code 
to be downloaded, the system has just started, an attempt to 
download code failed, or a reset has been issued. When RAM is 
displayed, the FEI-4 is running operational code and usually is 
waiting for work. 

f y Displays the f y driver control structures ( f y . c). 

f y c Displays the f y driver character special interface structures 

(fyc.c). 

f y i Displays the f y driver Internet Protocol (IP) structures 

(if_fyi.c). 

c [on t r o l_r eg] Displays current settings of the FEI-4' s LOSP control register. 

d[e f au 1 1 ] Displays the FEI-4' s default LOSP control register settings that 

were set when the code was built. After a reset, these are the 
settings that will be used. 

s [t atus - r eg] Displays the FEI-4 LOSP status register. 

- D binary Downloads the specified binary file to the FEI-4' s RAM and tells the FEI-4 to begin 

execution. This option is normally used by scripts run at boot time; you will not normally 
1 invoke it manually. 

- e action Modifies the execution trace control structure and determines whether the buffer area 

(allocated at compile time) will be overwritten. The default tracing actions are set in the 
f y_t race . h file at compile time. To change the unit and the mode of writing (once or 
c i r cu lar), you must specify two separate f yadmin command lines, action can be set 
to one of the following values. 

0 Enables tracing on unit 0 only. 

1 Enables tracing on unit 1 only. 

2 Enables tracing on unit 2 only. 

3 Enables tracing on unit 3 only. 

a [ 1 1] Enables tracing on units 0 through 3 . 

n [one] Stops the tracing activity. 

o[nce] Fills the area ofmemory allocated for tracing onceandthen stops; 

it does not overwrite itself. Use this value when you know that a 
certain sequence of events cause a problem but you do not have 
control over other concurrent processes. 

c [ i r cu 1 ar] Continuously performs traces and writes them to one area of 
memory, overwriting itself as needed. 

- r Resets the f y driver and its f y x modules; it is similar to the reset performed with a system 

boot. 

I 
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-ttype Displays the execution trace buffer or error trace buffer (which contains only the significant 

events) specified by type. The f y driver is normally compiled so that all modules use one 
common execution trace buffer; however, it can also be compiled so that each module ( f y , 
f y i, and f yc) has its own individual trace buffer. 

c [ommon] Dumps all information in the common execution trace buffers. 

e[r r or] Dumps the error trace buffers; only the major events are recorded in the 

error trace buffer. For example, a maj or event might be the 
reconfiguring of a channel or the occurrence of a LOSP channel error. 

f y Displays all execution trace buffer information for the f y module. (If 

the system is not configured for individual trace buffers, you will get an 
error message.) 

f y c Displays all execution trace buffer information for the f y c module. (If 

the system is not configured for individual trace buffers, you will get an 
error message.) 

f y i Displays all execution trace buffer information for the f y i module. (If 

the system is not configured for individual trace buffers, you will get an 
error message.) 

f 4 Displays all FEI-4 execution trace buffer information (FEI-4 only). 

- a file | - ofile Appends ( - a) or overwrites ( - o) the output of the f y adm i n command to file ; if no such 

file exists, it will be created. You cannot specify both - a and - o on the same command line. 

- z device Specifies the control device for the unit, device can be one of the following 

values: /dev/fyctlO, /dev/fyctll, /dev/fyctl2,or /dev/fyctl3. The 
default is / dev/ f yet 1 0 . 



EXAMPLES 



Example 1: Downloading Firmware 

The following example shows the command lines to download firmware to an FEI-4 and to verify that the 
FEI-4 is executing it: 

fei-test% fyadmin -z /dev/fyctll -b i 
fei-test% fyadmin -z /dev/fyctll -r 
fei-test% fyadmin -z /dev/fyctll -D /etc/fei4.fw 
fei-test% fyadmin -z /dev/fyctll -d fw 

FEI-4 is executing in RAM: 
fw state = a 
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Example 2: Displaying Low-speed Channel Configuration 

The following example shows the command line that displays the current low-speed (LOSP) channel 
configuration for the FEI-4: 

fei-test% fyadmin -z /dev/fyctll -d c 

CURRENT LOSP Control Register settings 
LOSP control reg = ac9c9e40 



++++++++++++++++++++++++++++++++++++++++++++ 



IMODE 


= 6N 


OMODE 


= 6N 


IRESET~ 


= 1 


ORESET~ 


= 1 


IFRCBUFOK~ 


= 1 


OCHANOK 


= 1 


IRDEL 


= 2 


EOPAR 


= 1 


LOSPCNTRST" 


= 1 


LOOPBACK 


= 0 


CMWDAT 


= 0 


CLRPERR~ 


= 1 


LED1 


= OFF 


LED2 


= OFF 


LED3 


= OFF 


LED4 


= ON 


DELRDY 


= 0 


WDI 


= 1 


CPUMCLR 


= 0 


IOMCLR 


= 0 


DEADMP 


= 0 


RTCINT 


= 0 


CONINT 


= 0 


CDISCEN 


= 1 


CLRITINT" 


= 1 


VICRESET 


= 0 


BERREN~ 


= 0 


ORDYDEL~ 


= 0 



++++++++++++++++++++++++++++++++++++++++++++ 



Example 3: Changing the FEI-4 Low-speed Channel Configuration 

The following example shows the command lines that change the FEI-4 low -speed (LOSP) channel 
configuration and display the new settings: 

fei-test% fyadmin -z /dev/fyctll -C 12_d 
fei-test% fyadmin -z /dev/fyctll -d c 



CURRENT LOSP Control Register settings 
LOSP control reg = ae9e9e40 

++++++++++++++++++++++++++++++++++++++++++++ 



IMODE 




12D 


OMODE 




12D 


SETTINGS 












IRESET~ 




1 


ORESET~ 




1 


IFRCBUFOK" 




1 


OCHANOK 




1 


IRDEL 




2 


EOPAR 




1 


LOSPCNTRST~ 




1 


LOOPBACK 




0 


CMWDAT 




0 


CLRPERR~ 




1 


LED1 




OFF 


LED2 




OFF 


LED3 




OFF 


LED4 




ON 


DELRDY 




0 


WDI 




1 


CPUMCLR 




0 


IOMCLR 




0 


DEADMP 




0 


RTCINT 




0 


CONINT 




0 


CDISCEN 




1 


CLRITINT" 




1 


VICRESET 




0 


BERREN~ 




0 


ORDYDEL" 




0 



++++++++++++++++++++++++++++++++++++++++++++ 
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FILES 

/usr / include/sundev/ f 4_h . h Header file that explains FEI-4 firmware states that are 

displayed with fyadmin -d fw 

/usr / inc lude / sundev/ f y_errs . h Header file that explains f y driver errors detected 

/usr / include/sundev/ fy_trace . h Header file that explains the default tracing actions 

SEE ALSO 

fy format (8) for information about formatting raw trace buffer information into ASCII text 



SR-3077 2.0 



82 



Cray Research, Inc. 



FYFORMAT(8) 



F YFORM AT ( 8 ) 



NAME 

fy format - Fonnats raw trace buffer information extracted from f y driver modules 

SYNOPSIS 

/etc/fyformat file 

DESCRIPTION 

The f y driver includes a set of common execution trace macros (f y_trace . h) to be used as a debugging 
aid. The f yadmin(8) program can be used to dump the raw trace information that any f y driver module 
(such as f yc) collects. The fy format program takes the raw trace data and formats it into readable 
ASCII text. 

file Specifies the dump file to be formatted by fy format. 

EXAMPLES 

The following example shows two command lines that produce files with raw and formatted trace buffer 
output: 

fei-test% fyadmin -z /dev/fyctll -t all -o rawdata 
fei-test% fyformat rawdata > f ormatted_trace 



fei-test% more rawdata 

1770 

29969a5e 86a01339 0 4 
29969a5e 86a01391 ff66fd80 0 

many more entries 

ffffffff ffffffff ffffffff ffffffff 
2996adl0 e2b011bc f81788c4 0 
2996adl0 e2b011b4 fff3f728 f81788c4 
2996adl0 e2b011b6 f8160804 0 
2996adl0 e2b011b8 fffl5218 15218 



fei-test% more f ormatted_trace 

Printing oldest execution trace entry first. 

Feb 10 10:49:20 unitl fy_wr_tib_done : entry, service 1 RIB f81788c4 0 

Feb 10 10:49:20 unitl fy_service_wr_rib : entry fff3f728 f81788c4 

Feb 10 10:49:20 unitl fy_service_wr_rib : got the TIB request f 8160804 0 

Feb 10 10:49:20 unitl fy_service_wr_rib : addresses of data fffl5218 15218 



SEE ALSO 

f yadmin(8) for information about dumping the raw trace information for the f y driver 
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NAME 

f yroute - Sets or displays the f y driver's IP Interface Routing table 

SYNOPSIS 

/etc/ f yroute interface -d 
/etc/fyroute interface -D 
/etc/ f yroute interface -s routingfile 

DESCRIPTION 

The f yroute command allows you to set or display the fy driver's Internet Protocol (IP) Interface 
Routing table. This table maps Internet addresses to physical hardware addresses. 

The arguments to f yroute are as follows: 

interface Specifies the interface whose table will be manipulated. The legal values for interface are 
fyiO, fyil, fyi2, and fyi3. 

-d Dumps the routing table in raw format (used for debugging routing code). 

- D Dumps the routing table in readable format. 

-s routingfile 

Sets the fy driver's IP routing table according to the information in routingfile. To specify 
standard input rather than a file, enter a hyphen (-). 

ROUTING FILE FORMAT 

The information in the routing file has the following format (fields marked "0" are unused): 
verb host destination 0 0 [mtu] ; 

Any amount of white space (blanks or tabs) can be used between items, and comments are preceded by * or # 
in column 1. Each statement must end with a semicolon. The components of statement lines are as follows: 

verb Specifies the type of connection. There are three valid values for verb: 

Value Description 

direct Specifies a point-to-point connection between host and destination. 

swloopback Specifies a software loop used for testing local software; destination 

must be the local interface address. (The module that actually loops the 
data around is the i f _f y i . c module.) 

hwloopback Specifies a hardware loop used for testing hardware loopback paths; 
destination must be the local interface address. 

host Specifies the Internet address. The value specified for host can be either a host name (such 

asfeitest-036)oran Internet address specified in dot notation (such as 
128 . 162 .33 .5). You can use dot notation to specify an Internet address that is not listed 
in /etc/hosts. 

destination Associates a logical path with an Internet address. The bottom 4 bits of destination 
specifies the logical path to use when sending data to the specified host. The value for 
destination must be specified as a hexadecimal number. (0 0 0 5 is usually the path for a CRI 
mainframe.) 
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mtu Specifies the maximum transfer unit (packet size), in bytes, that the IP layer will receive 

from the underlying layer; mtu must be specified as a decimal number. The default for mtu 
is 4144 bytes, and this is the maximum size. This value results from 4 Kbytes of data plus 
48 bytes of header (32 bytes of IOS parameter block header plus 1 6 bytes of Cray np . c 
header). 

Typically, you would first use swloopback to test the software connection, then hwloopback to test the 
hardware paths, and finally d i r e c t to test the connection to the CRI mainframe. 

EXAMPLES 

Suppose you have the following routing file named / etc/ f ycf . owse: 



# 
# 
# 

direct 
# 

direct 

swloopback 

hwloopback 



The first line is the local interface address 
feitest-036 0001 0 0 4144; 



snl600-036 0005 0 0 4144; 

feitest-swlp 0001 0 0; 
feitest-hwlp 0001 0 0; 



You can modify the driver' s current routing table to conform to the specifications in this file and then bring up 
the interface with the following f y r ou t e(8) and SunOS i f con f i g(8) command lines: 

owsl600% fyroute fyiO -s /etc /f ycf .owse 

owsl600% ifconfig fyiO feitest-036 netmask OxffffffOO 

The following example shows the use of the -d option: 

owsl60 0% /etc /fyroute fyiO -d 

table set time: Mon Feb 17 13:29:46 19 92 
hash 0 key dfffld05 flags 3 

dst 0005 ctl 0000 access 0000 mtu 4144 
hash 1 key dfffldOa flags b 

dst 0001 ctl 0000 access 0000 mtu 4144 
hash 2 key dfffldOb flags b 

dst 0001 ctl 0000 access 0000 mtu 4144 
hash 3 key dfffldOl flags 3 

dst 0001 ctl 0000 access 0000 mtu 4144 
gate[0] = 0 

The following example shows the use of the -D option: 



owsl600% /etc/fyroute fyiO -D 

direct snl600-036 0005 0000 0000 4144 

swloopback feitest-swlp 0001 0000 0000 4144 

hwloopback feitest-hwlp 0001 0000 0000 4144 

direct feitest-036 0001 0000 0000 4144 
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FILES 

/etc/hosts OWS-E host name database 

/etc/ f y c f . ows e Default routing file 

SEE ALSO 

hosts (5) for information about the SunOS host name database 

if conf ig(8) for information about the SunOS command that configures the network interface parameters 
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NAME 

getconf ig - Retrieves system parameter values from the system configuration file 

SYNOPSIS 

/bin/getconf ig parameter 

DESCRIPTION 

The getconf ig program serves as a command interface to the conf ig library routine, conf ig scans 
the system configuration file, /etc/conf igf ile, for a requested system parameter label and returns the 
associated system parameter value. 

The argument to getconf ig is as follows: 

parameter Specifies a system parameter label, parameter is one of the strings defined in 

/etc/conf igf ile. 

The / etc/conf igf ile file contains such parameters as path names of the default UNICOS kernel and 
parameter files, IOS-E binary files, and the various definitions necessary to configure the system dump 
device. All machine-dependent system parameters are also found in this file. 

Various system scripts use getconf ig when a system parameter value is required. 

The conf ig routine checks the OWSECONFIG environment variable for an alternate path name to the 
configuration file. 

FILES 

/etc/con figfile Default OWS-E configuration file 

RETURN VALUES 

If the parameter label is found, the associated string is written to standard output and a status of 0 is 
returned; otherwise, a status of 1 is returned. 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 
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NAME 

graphs - Displays CPU time statistics in graphic form 
SYNOPSIS 

/home /localhost /cri /bin/graphs [-h hostname] [-1 graphlabel] [-p port] graphlist 
DESCRIPTION 

The graphs command displays time statistics in graphic form. The program accepts data via a socket 
from cpud(8) and displays it in line-graph form. This application is based on XView, with the actual 
display contained within an XView base frame. 

The arguments to graphs are as follows: 

-h hostname Specifies the name of the host where the CPU daemon (cpud) is running. This argument 
is an Internet address of either ASCII format (such as host . cray . com) or numerical 
format (such asl92.9.30.126). The default is cpud_hostname in 
/etc/configfile. This option can be used to monitor mainframes not directly 
connected to the current OWS-E. If you specify the hostname as the name of the 
workstation connected to the mainframe of interest, the graphs client reads the socket 
of the cpud running on that OWS-E. 

-1 graphlabel Prefixes the default System Monitors base frame header with graphlabel : (for 
example, owsl600 : System Monitors). 

-p port Specifies the port on which cpud is listening. As released, this value is 4372. If the 

baseport parameter is changed in the /etc/configfile configuration file, then 
this default will be the new baseport value + 2. 

graphlist Indicates the CPU aspects to be monitored. A single graphs client may display a 

maximum of 15 graphs at one time. The valid graphlist values are as follows: 



Value 




Description 


idle 




Percentage of 


user 




Percentage of 


sysw 




Percentage of 


unix 




Percentage of 


idlec 


-n 


Percentage of 


userc 


-n 


Percentage of 


unixc 


-n 


Percentage of 



n is the CPU number; the CPUs begin with number 0. If you have 8 CPUs and you 
wanted to see graphs showing user time for the first CPU and the last CPU, you would 
enter userc-0 anduserc-7. 



The display consists of a canvas where each line graph is drawn, a title bar (consisting of 

graphlabel : System Monitors if graphlabel is specified, or System Monitors if it is not) and a 

short textual description beneath each displayed graph. 
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EXAMPLES 

The following command line displays the average idle, user, system-wait, and system time over all CPUs 
for system snl600: 

graphs -h owsl600.cray.com -1 snl600 idle user sysw unix 
RETURN VALUES 

If the graphs program exits successfully, a value of 0 is returned. If there is an error, a value of 1 is 
returned. 

BUGS 

You cannot resize the base frame. 

CONFIGURATION FILE PARAMETERS 

The graphs command reads the following parameters from /etc/conf igf ile: 

BASE PORT Defines the starting port value used for the various operator interface 

software daemons. Default: 

4370 

c PUD_HO S tname Specifies the name of the machine in which the CPU monitor, cpud(8), is 

running. Default: 

C PUDH 0 s TNAME token (replaced during installation) 

FILES 

/etc/configfile Default OWS-E configuration file 

SEE ALSO 

conf igf ile(5) for information about /etc/configfile 

cpud(8) for more information about gathering data and dispersing CPU time statistics 

OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for more information about CPU 

monitors and /etc/configfile 



SR-3077 2.0 



89 



Cray Research, Inc. 



HBEAT(8) 



HBEAT(8) 



NAME 

hbeat - Monitors the IOS-E system 
SYNOPSIS 

/home//0Ctf//&0Sf/cri/bin/hbeat [-r] 
DESCRIPTION 

The hbeat command continually polls each booted IOP, looking for either halt codes or clocks that have 
stopped (which indicates a hung system). If either condition is detected, a message is sent to the console 
informing the operator and the condition is logged in / var / logs / ioplog. hbeat is automatically 
started when the first IOP is booted. When an IOP halt is detected, hbeat runs the iophal t(8) script. 

The argument to hbeat is as follows: 

-r Restarts hbeat. hbeat reads /var/logs/sstbackup to find out which IOPs are 

currently running. It then initializes itself based on this file. Use this option if the hbeat 
process was killed or if the OWS-E has crashed. 

The hbeat command also sends all IOP halt messages to the SMARTE system running on the MWS-E 
maintenance workstation. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 

CONFIGURATION FILE PARAMETERS 

The hbeat command reads the following parameters from /etc/conf igf ile: 
SSTBACKUP Specifies the back-up hbeat(8) status table. Default: 

/var/logs/sstbackup 
IOPLOG Defines the path name of the IOP log file. Default: 

/var/ logs /ioplog 
IOPHALT Defines the path name of the iophalt script. Default: 

/ home / localhost/ cri/bin/iophalt 

ENVIRONMENT VARIABLES 

OWSECONFIG Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 

FILES 

/etc/con figfile Default OWS-E configuration file 

/etc/owsepermf ile Permissions file that contains a list of accounts and the 

commands they are allowed to access 

/home /localhost/ cri/bin/iophalt Default script that is run by hbeat when ahalt is 

detected 

/var/logs/ioplog Default IOP log file 

/var/logs/sstbackup Default file that hbeat uses to contain the last known 

image of the hbeat table 



SR-3077 2.0 



90 



Cray Research, Inc. 



HBEAT(8) 



HBEAT(8) 



SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/con f igf ile 

owsepermf ile(5) for information about the default OWS-E permission file 

emon(8) for more information about restarting the IOS-E error logging, heartbeat, and CPU monitors 

err logd(8) for more information about the IOS-E hardware error logging daemon, which receives error 

information from the IOS-E and logs it in the err log file 

iophalt(8) for information about dumping an IOP in the event of an IOP failure 

rcpud(8) for more information about the IOS-E remote CPU daemon, which processes service requests 

from the mainframe 

I/O Subsystem Model E (IOS-E) Guide, publication SD-2107, for information on iophalt. (This 
document contains information private to Cray Research, Inc. It can be distributed to non-CRI personnel 
only with approval of the appropriate Cray Research manager.) 
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NAME 

hcon - Configures aMUXIOP high-speed channel up or down 
SYNOPSIS 

/home/localhost/cri/bin/hcon [-c cluster] [-d] [-D] [-m mode] [-t target] hisp 
DESCRIPTION 

The hcon command configures up aMUXIOP high-speed channel by default. The channel is configured 
down if you specify the -d option. The MUXIOP of the designated cluster must be running. 

The arguments to the hcon are as follows: 



-c cluster 

-d 

-D 

-m mode 



-t target 



Specifies the number of the cluster in which the MUXIOP resides. The range of valid 
cluster numbers depends on the number of clusters in the IOS-E. The default is 0 . 

Configures the channel down. If you do not specify this option, hcon configures the 
channel up. 

Sets debug mode for the hcon program and sends the output to standard error. 

Specifies the channel mode; this option is not normally used, because the correct mode is 
chosen for you when you specify the - 1 option, mode can be one of the following 
values: 

clOOdlOO 100 Mbytes/s for control and 100 Mbytes/s for data. (Thisis 
the default when you specify -t ssd-D.) 

cl00d200 100 Mbytes/s for control and 200 Mybtes/s for data. (This is 
the default when you specify -t ymp . ) 

c200d200 200 Mbytes/s for control and 200 Mbytes/s for data. (This is 
the default when you specify -t ssdor -t c90.) 

Sets target memory for the high-speed channel, target can be one of the following 
values: 

ymp CRAY Y-MP central memory (default) 

c 9 0 CRAY Y-MP C90 central memory 

s s d Model E SSD memory 

ssd-D Model D SSD memory 



hisp 



Specifies the high-speed channel number, which can be either 0 or 1. 

Log messages generated by this command are sent to the file specified by the IOPLOG parameter in 
/etc/conf igf ile. By default, IOPLOG is set to /var/logs/ioplog. Error messages are written 
to standard error. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 
EXAMPLE 

The following example configures MUXIOP high-speed channel number 1 up for IOS 0, cluster 3, using 
SSD-E memory: 



hcon -c 3 -t ssd 1 
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CONFIGURATION FILE PARAMETERS 

The command reads the following parameters from / etc/configfile: 
I o plog Defines the path name of the IOP log file. Default: 

/var/logs/ioplog 

FILES 

/etc/configfile Default OWS-E configuration file 

/etc/ ows epermf i 1 e Permissions file that contains a list of which accounts may access 

each command 

/ var / 1 og s / i op 1 og Default path name of the IOP log file 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator' s Guide, publication SG-3079, for 
information about /etc/configfile 

owsepermf i le(5) for information about the default OWS-E permission file 

econ(8) for information about configuring a MUXlOP-to-EIOP low-speed channel up or down 

I 
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NAME 

iophalt - Dumps an IOP in the event of an IOP failure 
SYNOPSIS 

/ home /localhost/ cri /bin/ iophalt cluster iop [message] 
DESCRIPTION 

The iophalt script is usually invoked by hbeat(8); you should not need to invoke it directly. 

When hbeat encounters an IOP failure, the iophalt script uses the edump command to take dump 
images of the IOP in question and the MUXIOP for that cluster, edump places the dump images in the file 
specified by the DEFAULTIDUMPDIR parameter in /etc/conf igf ile; by default, this file is 
/var/ dumps, iophalt places message in the file specified by the IOPLOG parameter in 
/etc/conf igf ile; by default, this file is /var/logs/ioplog. 

The arguments to iophalt are as follows: 

cluster Specifies the number of the cluster on which the IOP to be dumped is located, cluster can 

be an integer value in the range 0 through 7; you may specify only one cluster. There is 
no default. 

iop Specifies the IOP (or multiple IOPs) to be dumped, iop can be an integer value in the 

range 0 through 4 (4 indicates the MUXIOP), mux, or all; to specify more than one 
IOP, separate the IOP numbers with a comma (for example, 0,1,3). There is no 
default. 

message Specifies the reason for taking a dump of the IOP. The message can be up to 80 

characters in length; the string must be enclosed in quotation marks if it contains white 
space. 

iophalt also sends mail to the destination specified by the MAIL_I0PFAIL parameter in 
/etc/conf igf ile; usually, mail is sent to the system administrator. To specify more than one user, 
use the SunOS alias es(5) file. 

The system administrator should modify the DEFAULTIDUMPDIR and MAIL_I0PFAIL configuration 
parameters to site-specific values. 

CONFIGURATION FILE PARAMETERS 

The iophalt command reads the following parameters from /etc/configfile: 

DEFAULTIDUMPDIR Defines the default dump directory path in which the dump shell script is created. 
Default: 

/var/dumps 

IOPLOG Defines the path name of the IOP log file. Default: 

/var/logs/ioplog 
MAIL_I0PFAIL Defines the login name to which mail is sent if an IOP halts. Default: 

cri 
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FILES 



/var / logs / ioplog 



/etc/conf igf ile 



/var /dumps 



Default OWS-E configuration file 
Default dump file 
Default IOP log file 



SEE ALSO 



aliases(5) for information about the SunOS file for sendmail(8) 

conf igf ile(5) and OWS-E Operator Workstation Administrator' 's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

boot sys(8) for information about the command that boots the IOS-E and the mainframe 
edump(8) for information about dumping IOP local memory images to the OWS-E 
hbeat(8) for information about tine heartbeat monitor, which calls iophalt 
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NAME 

lapdaemon - Validates CRT tty lines for users 



SYNOPSIS 

home / localhost/ cri/bin/1 apdaemon 



DESCRIPTION 

The lapdaemon program is called by the z ip(8) program when you try to open a tty line. If you do 
not specify a particular tty line, lapdaemon will find the first line available, beginning with line 1; if 
lines 1 through 4 are all busy, it will then check the console line (line 0). If you do not request a specific 
line and all lines are busy, the line held by a user with a lower permission than yours will be usurped if 
usurp mode has been toggled on. If you request a specific line and that line is busy, the line will be usurped 
from the present owner if he or she has a permission lower than yours and if usurp mode has been toggled 
on. The owner of a line is sent a message if the line he or she has is usurped. 

lapdaemon uses a priority file to determine the priority of users. The location of this file is specified by 
the LAPFILE ("line arbitration priority file") parameter in /etc/conf igf ile; by default, LAPFILE is 
set to /etc/lapf ile. 

CONFIGURATION FILE PARAMETERS 

The lapdaemon command reads the following parameter from /etc/conf igf ile: 

LAPFILE Specifies the location of the line-arbitration priority file used by lapdaemon(8). 

Default: 

/etc/lapf ile 

ENVIRONMENT VARIABLES 

owseconfig Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 

FILES 

/etc/ con f ig f i 1 e Default OWS-E configuration file 

/etc/1 ap file Default line arbitration priority file 



SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

lapf i le(5) for information about the line arbitration priority file 

z ip(8) for information about the command that supplies the terminal interface to a running 
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NAME 

mf dump - Dumps the mainframe memory and CPU registers to a CRI disk on the IOS-E 
SYNOPSIS 

/home//0caZ/20S?/cri/bin/mfdump [-b bootstrap] [-c cluster] [-D] [-f file] [-F] [-i iop] [-q] 
[-v] [reason] 

DESCRIPTION 

The mf dump command dumps the mainframe memory and CPU registers to a CRI disk on an IOS-E. The 
dumped binary resides on the preallocated dump slice and can be moved to a spot in the file system upon 
reboot of the mainframe. Cluster 0 is the cluster through which the CPU dump binary is to be routed. 

The arguments to mf dump are as follows: 

-b bootstrap Specifies the full path name of the bootstrap loader program for the CPU. If you do not 
specify this option, the default program is the one specified by MFBOOT in 
/etc/conf igf ile; by default, this program is 

/home / localhost/ cr i / os /ut s /mf boot . 

-c cluster Specifies the IOP cluster to use for data transfer and deadstart functions. The range of 

valid cluster numbers depends on the number of clusters in the IOS-E. The default is 0 . 

-D Sets debug mode in the mf dump program and sends the output to standard error. 

- f file Specifies the path name of the CPU-resident system dump program. If you do not 

specify this option, the default program is the one specified by MFSYSDMP in 
/etc/conf igf ile; by default, this program is 

/home//0Ctf//w.rt/cri/os/uts/mf sysdmp. 

-F Forces a dump. If there is a dump on the default slice and you try to take another dump, 

you will get an error message. (The default slice is the area of memory defined by 
DIOPATH, which defines the channel and IOP cluster, DUNIT, which defines the unit of 
the disk drive, DSTART, which defines the starting address on the disk, and DLEN, 
which defines the length of the slice. The defaults for these parameters are set in 
/etc/conf igf ile.) However, if you use the -F option, the current dump will 
overwrite the existing dump. You should use this option if the current dump is more 
important than the first dump. 

- i iop Specifies the number of the IOP through which to route, iop can be set to an integer from 

0 through 4; 4 specifies the MUXIOP. The default is 0. 

-q Queries you for memory types to dump. Memory ranges and types can be changed from 

the defaults, which are set in the mf dump program. 

-v Sets verbose mode. This option forces mf dump to print informative messages to 

standard error. 
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reason Specifies the reason for the dump; for example, " CPU Hung " . Quotation marks are 

optional, even if the reason contains white space; however, you should use them to avoid 
problems with special characters, reason is truncated after 79 characters, not including 
quotation marks (a longer reason will not cause an error, but the 80th and succeeding 
character will not be used). If you do not add reason in the command line, you will be 
prompted for it later. Although it is not required, adding this explanation in the 
command line is especially useful if you intend to use scripts for autoboots or 
autodumps; if you do so, you will not have to wait for the system to prompt you for a 
reason. Entering a halt code as a reason also helps to distinguish dumps as dump files 
start to accumulate. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 



EXAMPLES 

The mf dump command is found on the OWS-E. The path from the OWS-E to the mainframe is by way of 
cluster 0 and IOP 0. The path from the mainframe to the dump device is by way of the dump cluster and 
dump IOP; the defaults for these are set with the DIOPATH parameter in /etc/conf igf ile. DIOPATH 
is a composite value made up of the dump device's cluster (the first digit), IOP (the second digit), and a 
channel number. 

To route the binary into the mainframe, you must halt all of the EIOPs with the ehalt command and then 
reboot the default cluster's MUXIOP with the eboot(8) command. When you have done this, you must 
configure up the high-speed channel from the default cluster's MUXIOP to the mainframe with neon. You 
can then reboot the EIOPs and configure the channel from the MUXIOP to the EIOPs using the eboot(8) 
and econ(8) commands. Finally, you can take the dump with the mf dump command. 

The following example shows the procedure you could follow, as an alternative to boot sys - i, to route 
the dump binary through cluster 0, IOP 0, and place the dump image on the dump cluster and IOP (which in 
this case are cluster 0 and IOP 2): 



owsl6 0 0% getconfig DIOPATH 

00230 (Dump to cluster 0, IOP 2, channel 30) 

owsl600% ehalt 0:0-4 

owsl600% eboot -P 0 :4 : ~cri/os/ios/iopmux (Boots MUXIOP) 

owsl600% hcon-cO-t ymp 0 (Configures connection between MUXIOP and CPU) 

owsl600% eboot 0 : 0 : ~cri/os/ios/eiop.comm (Boots EIOP for loading mainframe) 

owsl600% eboot 0 : 2 : ~cri/os/ios/eiop.dcal (Boots EIOP for disk to receive dump image) 

owsl6 00% econ -c 0 0 (Configures up LOSP between) 

owsl600% econ -c 0 2 (EIOPS and the MUXIOP) 

o w g 1 6 0 0 % mf dump " CPU hung " (Takes the dump) 
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CONFIGURATION FILE PARAMETERS 

The command reads the following parameters from /etc/conf igf ile: 

DOFWA 
DOLWA 
D1FWA 
D1LWA 
D2FWA 
D2LWA 
D3FWA 



D3LWA 



DEFAULTUPARAMF ILE 



DEF MFCHAN 



DIOPATH 



DLEN 



DSTART 



DTYPE 



DUNIT 



IOPLOG 



MFBOOT 



These parameters define the actual mainframe memory ranges to be 
dumped. Default: 

At release, only the first range is specified, and the other ranges 
are set to 0. This first range is set to start at word address 0 and 
end at word address 020000000. 

Defines the path name to the default UNICOS parameter file. Default: 

/ home / localho stj c r i / o s / u t s / par am 

Defines the mainframe channel number of the low-speed channel 
attached to the cluster that deadstarts the mainframe. Default: 

020 

Defines the path that the memory dump will take from the mainframe 
to the disk. Default: 

DUMP IO token (replaced during installation) 

Defines the length, in sectors, of the disk slice to which the memory 
will be dumped. Default: 

DUMPLEN token (replaced during installation) 

Defines the starting sector of the disk slice to which the memory will 
be dumped. Default: 

DSTARTBL token (replaced during installation) 

Defines the type of the disk to which the mainframe memory will be 
dumped. Default: 

DUMPTYPE token (replaced during installation) 

Defines the default dump device unit that the mf dump(8) command 
uses when routing the mf sysdmp binary file to the mainframe before 
the dump. Default: 

DUMPUNIT (replaced during installation) 

Defines the path name of the IOP log file. Default: 

/var/ logs / ioplog 

Defines the path name of the bootstrap loader program used by the 
mf dump(8) command. Default: 



/home/ localhost / cri / os /uts /mt boot 
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MFSYSDMP 



Defines the path name of the CPU-resident program used by the 
mf dump(8) command. Default: 



SSD_MEMORY 



/home /localhost/cr i /os /ut s /mf sysdmp 

Defines the memory size of the SSD attached to the mainframe to 
which the OWS-E is attached. Default: 



SSD_MEMORY token (replaced during installation) 



ENVIRONMENT VARIABLES 



OWSECONFIG 



Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 



FILES 



/etc/owsepermf ile 



/ home / localhost/ cr i / os /ut s /mf boo t 



/home /localhost/ cri. /os /uts/mf sysdmp 



/etc/conf igf ile 



Default OWS-E configuration file 

Permissions file that contains a list of accounts and 
the commands they are allowed to access 

Default bootstrap loader program 

Default CPU-resident system dump program 



SEE ALSO 



conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about / etc/con figfile 

owsepermf ile(5) for information about the default OWS-E permission file 
cpudump(8) for information about the script that boots the IOS and forces a UNICOS dump 
eboot(8) for information about booting the IOS-E from the OWS-E 
econ(8) and hcon(8) for information about configuring the IOS-E MUXIOP channels 
edump(8) for information about dumping IOP local memory images to OWS-E 
ehalt(8) for information about halting the IOS-E 

hcon(8) for information about configuring the high-speed channel on the MUXIOP 
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NAME 



mf init - Runs a mainframe and IOS-E initialization and confidence test 



SYNOPSIS 



/home/focaZ/zosf/cri/bin/mf init [-c cluster] [-C cpus] [-D] [-f pathname] [-1 iop] 
[-1 clusters] [-n errors] 



DESCRIPTION 



The mf init command runs a confidence check, mf chkye, in the CPU. (The name mf chkye refers to 
"mainframe check on the CRAY Y-MP and IOS-E.") mf init issues a master clear function through the 
MUXIOP, loads the test binary through a running EIOP, and issues a drop master clear function through the 
same MUXIOP. The test checks memory and registers in all CPUs and reports status in a response block in 
CPU memory, mf init polls the response block and reports any failures to the operator. 

The mf init command allows you to set a maximum error count after which the program aborts. 

The arguments to mf init are as follows: 

-c cluster Specifies the number of the cluster to be used to control the master clear deadstart lines. 

The range of valid cluster numbers depends on the number of clusters in the IOS-E. The 
default is 0. 

-c cpus Specifies the number of CPUs to test, beginning with CPU 0. The range of valid CPUs 

depends on the number of CPUs available at your site. (If you enter 4 and have 8 CPUs 
available, CPUs 0 through 3 will be tested.) If you do not enter the -c option, the 
default number of CPUs tested is the total number of CPUs for which your system is 
configured. 

- D Sets debug mode in the mf i n i t program and sends the output to standard error. 

- f pathname Specifies the full path name of the mainframe test to load. If you do not enter the - f 

option, the default is specified by the MFIPATH parameter in /etc/conf igf ile; at 
release, MFIPATH is set to /hovae/localhost/cri/os/uts/mf chkye. 

- i iop Specifies the number of the EIOP to be used to load the mainframe, iop can be set to an 

integer in the range 0 through 3. If you do not enter the -i option, the default is 0. 

- 1 clusters Specifies the number of cluster registers to test on the mainframe. The range of valid 
clusters is machine dependent. If you do not specify the - 1 option, the default is the 
hardware configuration for cluster registers. 

-n errors Specifies the maximum number of errors allowed before aborting the test. If you do not 

specify this option, the default is 1 6. 

The mf ini t command also sends all CPU faults to the SMARTE system running on the MWS-E 
maintenance workstation. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 
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EXAMPLES 

The following examples show the typical use of mf in it and testing for specified CPUs. 

Example 1: Typical Use 

In most cases, you will enter mf in it without any options: 

mf init 

Example 2: Testing Specified CPUs 

Suppose you had 8 CPUs and you wanted to test the first 6 of them. You would enter the following: 

mfinit -C 6 

CONFIGURATION FILE PARAMETERS 

The mfinit command reads the following parameters from /etc/conf igf ile: 

MF I PATH Defines the path name of the diagnostic program used by the mf i n i t command. 

Default: 

/ home / localhost/ cri/os/uts/mf chky e 

FILES 

/etc/configfile Default OWS-E configuration file 

/etc/owsepermf ile Permissions file that contains a list of accounts and the 

commands they are allowed to access 

/home / localhost / cri / os /\it s /mf chkye Default mainframe test file 
SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/configfile 

owsepermf i le(5) for information about the default OWS-E permission file 

boot sys(8) for information about booting the IOS-E and the mainframe, using values from the UNICOS 
parameter file rather than scripts 
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NAME 



mf start - Starts the mainframe CPUs from the OWS-E 



SYNOPSIS 



/home /localhost/cri/bin/mf start [-c cluster] [-D] [-f filesystem] [-i iop] [-m mainframe] 
[-p parameter] [-u unicos] [-U unicos] [-v] 



DESCRIPTION 



The mf start command starts the mainframe CPUs from the OWS-E. mf start issues a master clear 
function through the MUXIOP, loads the binary through a running EIOP, and issues a drop master clear 
function to the MUXIOP. 

mf start starts the rcpud daemon if it is not currently running. 
The arguments to mf start are as follows: 



Specifies the number of the cluster to be used to control the master clear deadstart lines. 
The range of valid cluster numbers depends on the number of clusters in the IOS-E. The 
default is 0. 

Sets debug mode in the mf start program and sends the output to standard error. 

Specifies the full path name of an install file system to load on a new system. 

Specifies the number of the EIOP to be used to load the mainframe, iop can be set to an 
integer in the range 0 through 3 . The default is 0 . 

Specifies the mainframe channel number to which the deadstarting MUXIOP is 
connected. The default channel number is specified by the DEF_MFCHAN parameter in 
/etc/conf igf ile; at release, this parameter is set to 020. 

Specifies the full path name of the parameter file to use. If you do not specify the -p 
option, the default parameter file is the one specified by the DEFAULTUPARAMF ILE 
label in /etc/conf igf ile; by default, this file is 
/home //oca/ftosf / cr i / os /u t s /param. 

Specifies the full path name of the UNICOS binary file to use. If you do not specify the 
-u option, the default UNICOS binary file is the one specified by the 
DEFAULTUKERNFILE label in /etc/conf igf ile; by default, this file is 
/home / localhost /cri/os/uts /unicos. 

Specifies the full path name of the CPU-resident UNICOS binary file. 

-v Sets verbose mode. This option forces mf start to print informative messages to 

standard error. 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 

CONFIGURATION FILE PARAMETERS 

The command reads the following parameters from /etc/configfile: 

DEFAULTUPARAMF ile Defines the path name to the default UNICOS parameter file. Default: 

/ home / localhost/ cri/os/uts / par am 

DEFAULTUKERNF ILE Defines the path name to the default UNICOS binary. Default: 

/ home / localhost/ cri/os/uts/unicos 



-c cluster 
-D 

- f filesystem 
-i iop 

-m mainframe 
-p parameter 

-u unicos 

-U unicos 
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DEF_MFCHAN 



Defines the mainframe channel number of the low-speed channel 
attached to the cluster that deadstarts the mainframe. Default: 



020 



RCPUD 



Defines the path name of the remote CPU request daemon. Default: 



/home /localhost/ cr i /bin / rcpud 



FILES 



/ home / localhost/ c r i / o s / u t s /un i co s 



/ home / localhost/ cri/os/uts/param 



/etc/conf igf ile 



/etc/owsepermf ile 



Default OWS-E configuration file 

Permissions file that contains a list of accounts and the 
commands they are allowed to access 

Default parameter file 

Default UNICOS binary file 



SEE ALSO 



conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

owsepermf i le(5) for information about the default OWS-E permission file 

boot sys(8) for information about booting the IOS-E and the mainframe using values from the UNICOS 
parameter file, rather than scripts 

rcpud(8) for information about the IOS-E remote CPU daemon 
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NAME 



newlog - Creates new errlog and ioplog files while backing up the existing ones 

SYNOPSIS 

/home/toca/Ao^/cri/bin/newlog 

DESCRIPTION 

The newlog script backs up the log files defined by the errlog and ioplog labels in 
/etc/conf igf ile. For example, it moves the contents of the file err log. 2 to errlog . 3, the 
contents of errlog . 1 to errlog . 2, and so on. For example, this allows you to keep logs for the 
previous four days if newlog is run once a day. 

EXAMPLES 

You might want to use newlog in a crontab file. For example, if you wanted to run newlog every day 
at midnight, you could have the following line in /var/spool/cron/crontabs/cri: 



0 0*** /bin/sh /home/Zoca/Zmf/cri/bin/newlog 



CONFIGURATION FILE PARAMETERS 



The newlog command reads the following parameters from /etc/conf igf ile: 
ERRLOG Defines the path name of the error logging daemon. Default: 



/ home / /oca//&0,stf / c r i / b i n / e r r 1 ogd 
I o plog Defines the path name of the IOP log file. Default 



/var/ logs /ioplog 



FILES 



/etc/conf igf ile 



Default OWS-E configuration file 



SEE ALSO 



crontab(l) and crontab(5) for information about the SunOS command and file used to run periodic 
jobs 

conf igf ile(5) and OWS-E Operator Workstation Administrator' s Guide, publication SG-3079, for 
information about /etc/conf igf ile 
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NAME 



olnet - Detects and isolates network problems with the OLNET on-line diagnostic network 
communications tool 

SYNOPSIS 

/ home / localhost/ cr i / smarte / bin/olnet [subcommands] 
DESCRIPTION 

The olnet program detects and isolates network problems. For the OWS-E, olnet tests the network 
connection using the f y driver through the FEI, the low-speed channel, and the IOS channel adapter to the 
CRI mainframe. 

You can use olnet in either interactive mode or command-line mode; the commands are the same. (For 
details about the commands, see OLNET On-line Diagnostic Network Communications Program 
Maintenance Manual for UNICOS, publication SMM-1021.) 

Interactive Mode 

When you enter olnet by itself, you will get the following main menu: 

OLNET main menu 



VT - Call the VME test. 
H - Help with OLNET. 
QT - Quit OLNET. 

You must enter one of these commands: VT, H, or QT. If you enter VT, olnet displays the VME test menu, 
which is as follows: 



VME TEST 



Command 



Value 



PC 
MP 
AL 
PT 
MD 
RA 
TM 
DV 



Pass count > 

Messages/pass > 

Associated data length --> 

Pattern type > 

Message proper data > 

Remote address (Hex) > 

Test mode > 

Device path > 



1 

10 
100 

ADDRESS 
DISABLED 
undefined 
Active mode 
undefined 



Local address information 



Value 



Local address (hex) 



> undefined 
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Execute/exit commands 



EX - Execute the current VME test mode. 

H - Helpful information. 

RT - Return to the Main menu. 

QT - Quit OLNET . 

Command-line Mode 

To use command-line mode, enter olnet, followed by the subcommands and arguments you want; 
separate each subcommand and argument from the next by a comma. The subcommands are those shown 
in the olnet menus. For example, the following command line enters olnet, executes the VT (change 
to VME test menu) command, and sets the device path to /dev/ fycO 1 with the DV command: 

olnet VT,DV, /dev/fycOl 

At this point, olnet would display the following: 

VME TEST 



Command Value 



PC - Pass count > 1 

MP - Messages pass > 10 

AL - Associated data length --> 100 

PT - Pattern type . > ADDRESS 

MD - Message proper data > DISABLED 

RA - Remote address (Hex) > undefined 

TM - Test mode > Active mode 

DV - Device path > /dev/fycOl 

Local address information Value 



Local address (hex) > undefined 



Execute/exit commands 



EX - Execute the current VME test mode. 

H - Helpful information. 

RT - Return to the Main menu. 

QT - Quit OLNET. 

NoticethatDV - Device path is now set to /dev/ fycOl. 
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SEE ALSO 

OLNET On-line Diagnostic Network Communications Program Maintenance Manual for UNICOS, 
publication SMM-1021. 

UNICOS 6.E Early Release Software On-line Diagnostic Technical Note, publication SPN-1022. (These 
manuals are Cray Research Proprietary; dissemination of this information to non-CRI personnel requires 
approval from the appropriate vice president and a nondisclosure agreement. Export of technical 
information in this category may require a Letter of Assurance.) 
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NAME 



peek - Peeks (looks) at memory 



SYNOPSIS 



/home / localhost / cri /bin/peek -t type [-b channel] [-c cluster] [-D ] [-d display] 
[-f format] [-i iop] [-v] address[, size] 



DESCRIPTION 



The peek command allows a user to read any memory type. The types are CPU memory, SSD memory, 
IOP local memory, and channel buffer memory. If CPU or SSD memory is to be read, a MUXIOP and an 
EIOP must be running. Channel buffer memory is accessible only through an EIOP. 

The arguments to peek are as follows: 

-t type Specifies the memory type, type can be set to cbuf (channel buffer), cpu, iop, or 

ssd. You must specify this option; there is no default. If you specify cbuf, you must 
also specify the -b option. 

-b channel Specifies the channel buffer channel number when you specify cbuf for -t. channel 
can be set in the range 03 0 to 037; to specify octal, you must use a leading 0. This 
option is only valid when you specify - 1 cbu f , and is required with - 1 cbu f . 

-c cluster Specifies the number of the IOS-E cluster to be used. The range of valid cluster numbers 

depends on the number of clusters in the IOS-E. The default is 0. 

-D Sets debug mode in the peek program and sends the output to standard error. 

-d display Specifies the display type, display can be set to hex (hexadecimal) or octal. The 

default is octal. 

- f format Specifies the format of the display, format can be set to word, parce 1, byte, bit, 

elan (IOP instruction format), or trace (trace buffer dump). The default depends 
upon what you specify for -t: parcel if you specify iop for -t; word if you 
specify cbuf, cpu, or ssd for -t. 

- i iop Specifies the number of the IOP to be used, iop can be set to an integer in the range 0 

through 4. The default is IOP 0 if you specify cpu, iop, or ssd for the -t option; 
however, if you specify cbuf for the -t option, you must specify this option (there is 
no default with cbuf). 

/ 

-v Sets verbose mode. This option forces peek to print informative messages. 

address Specifies the starting octal address. You must enter this operand; there is no default. 

size Specifies the number of units looked at from the starting address. For IOP memory, the 

unit is a parcel; otherwise, the unit is a word. The default is 1 unit. If you specify size, 
you must separate it from address with a comma ( , ). 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 



FILES 



/etc/owsepermf ile 



Permissions file that contains a list of accounts and the 
commands they are allowed to access 



SEE ALSO 



owsepermf ile(5) for information about the default OWS-E permission file 

ecrash(8) for more information about examining an IOS-E dump image or viewing a running system 
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NAME 



poke - Pokes (places) a pattern into memory 



SYNOPSIS 



/home//oca//z0sf/cri/bin/poke -p pattern -t type [-b channel] [-c cluster] [-D] [-i top] [-v] 
address[ , size] 



DESCRIPTION 



FILES 



The poke command allows a user to place a pattern into any memory type. Types are CPU memory, SSD 
or IOP local memory or channel buffer memory. To write to CPU or SSD memory, a MUXIOP and an EIOP 
must be running. Channel buffer memory is accessible only through an EIOP. 

The arguments to poke are as follows: 

-p pattern Specifies an octal or hexadecimal pattern of up to 64 bits to set into memory (16 bits if 

IOP memory). 

-t type Specifies the memory type, type can be set to cbuf (channel buffer), cpu, iop, or 

ssd. You must specify this option; there is no default. If you specify cbuf, you must 
also specify the -b option. 

-b channel Specifies the channel buffer channel number when you specify cbuf for -t. channel 
can be set in the range 030to 037;to specify octal, you must use a leading 0. This 
option is only valid when you specify -t cbuf, and is required with -t cbuf. 

- c cluster Specifies the number of the IOS-E cluster to be used. The range of valid cluster numbers 

depends on the number of clusters in the IOS-E. The default is 0. 

-D Sets debug mode for the poke program and sends the output to standard error. 

- i iop Specifies the number of the IOP to be used, iop can be set to an integer in the range 0 

through 4. The default is IOP 0 if you specify cpu, iop, or ssd for the -t option; 
however, if you specify cbuf for the -t option, you must specify this option (there is 
no default with cbuf). 

-v Sets verbose mode. This option forces poke to print informative messages to standard 

error. 

address Specifies the starting octal address. You must enter this operand; there is no default. 

size Specifies the number of units peeked from the starting address. For IOP memory, the 

unit is a parcel; otherwise, the unit is a word. The default is 1 unit. If you specify size, 
you must separate it from address with a comma (, ). 

Permission to access this command is set in /etc/owsepermf ile by the system administrator. 



/etc/owsepermf ile 



Permissions file that contains a list of accounts and what commands they 
are allowed to access 



SEE ALSO 



owsepermf ile(5) for information about the default OWS-E permission file 

ecrash(8) for more information about examining an IOS-E dump image or a running system 
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NAME 

rcpud - Processes service requests from the mainframe (IOS-E remote CPU daemon) 

SYNOPSIS 

/ home / localhost/ c r i / b i n / r cpud 

DESCRIPTION 

The rcpud daemon processes service requests from the mainframe. Requests to perform services for the 
CPU are sent through O-packets from the mainframe. Services include the following: starting an IOP; 
halting an IOP; placing an IOP on-line (upping); placing an IOP off-line (downing); notifying the operator 
that an IOP is alive or has died; getting the CPU time and date; and notifying the operator of a CPU panic. 
Upon performing the remote service, rcpud returns status information to the mainframe through an 
O-packet. When UNICOS panics, rcpud runs the script /home/Zocfl/Ziosr/cri/bin/cpupanic, 
which can do such things as dumping and restarting the system. 

The rcpud daemon also sends all CPU panic messages to the SMARTE system running on the MWS-E 
maintenance workstation. 

CONFIGURATION FILE PARAMETERS 

The rcpud command reads the following parameters from /etc/conf igf ile: 
CPUPANIC Defines the path name of the cpupanic script. Default: 

/ home / localhost/ cri/bin / cpupan i c 

ENVIRONMENT VARIABLES 

owseconf IG Specifies the system configuration file; by default, it is set to 

/etc/conf igf ile 

FILES 

/etc/conf igf ile Default OWS-E configuration file 

/home / localhost/ cr i /bin/cpupanic Script that dumps and restarts the system when 

UNICOS panics. 

SEE ALSO 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

cpupan ic(8) for information about the script rcpud calls to take a UNICOS panic dump 
emon(8) for information about restarting the IOS-E error logging and heartbeat monitors 
hbeat(8) for information about monitoring the IOS-E system 
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NAME 

smdemon - Monitors the OWS-E system for SMARTE 



SYNOPSIS 

/ home / localhost/ c r i / smar t e / b i n / smdemon 



DESCRIPTION 

The SMARTE OWS-E system monitor daemon, smdemon, is used by the System Maintenance and Remote 
Testing Environment (SMARTE) product as its interface to the OWS-E. 

smdemon gathers UNICOS panic messages, IOS-E halt messages, static IOS-E configuration, and dynamic 
IOS-E configuration from the OWS-E. 



SEE ALSO 

smdstop(8) for information about the command to stop smdemon 

System Maintenance and Remote Testing Environment (SMARTE) Guide, publication SPM-1017. (This 
document is Cray Research Proprietary; dissemination of this information to non-CRI personnel requires 
approval from the appropriate vice president and a nondisclosure agreement. Export of technical 
information in this category may require a Letter of Assurance. This manual is currently available in draft 
form.) 
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NAME 

smdstop - Terminates the SMARTE OWS-E system monitor daemon 
SYNOPSIS 

/home //oca/ZzosZ/cri/smarte/bin/ smdstop 
DESCRIPTION 

The smdstop command sends a software termination signal (SIGTERM) to the OWS-E system monitor 
daemon, smdemon(8). 

SEE ALSO 

signal(3V) for information about the Sun OS simplified software signal facilities and SIGTERM 
smdemon(8) for information about the system monitor daemon 

System Maintenance and Remote Testing Environment (SMARTE) Guide, publication SPM-1017. (This 
document is Cray Research Proprietary; dissemination of this information to non-CRI personnel requires 
approval from the appropriate vice president and a nondisclosure agreement. Export of technical 
information in this category may require a Letter of Assurance. This manual is currently available in draft 
form.) 



SR-3077 2.0 



113 



Cray Research, Inc. 



SNMPROUTE(8) 



SNMPROUTE(8) 



NAME 

snmp route - Performs route tracing with the Simple Network Management Protocol 
SYNOPSIS 

/usr/ucb/snmproute [-c community] [-v] fromaddress toaddress 
DESCRIPTION 

snmproute uses the Simple Network Management Protocol (SNMP) protocol to trace a route from a 
source location to a destination location. For this command to work correctly, it is important that all 
intermediate nodes support SNMP and the MIB-II (RFC 1213) variables. 

The snmproute command accepts the following options: 

-c community Specifies community name used for SNMP packets. The default is the community name 
public. 

-v Sets up snmproute in a verbose mode. More information is displayed. 

fromaddress Specifies source address. 
toaddress Specifies destination address. 

SEE ALSO 

snmpd(8) 
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NAME 

xsnmpmon - Invokes the SNMP network monitor 

SYNOPSIS 

(On ows-E) 

/home/foca/ZzosT/cri/bin/xsnmpmon [-d display | -display display] [-bd bordercolor] 
[-bg backgroundcolor] [-fg foregroundcolor] [-fn font] [-lfn largefont] [-ib file] [-iconic] 

(On CRI mainframe) 

/usr/ lib/monitor /xsnmpmon [-d display | -display display] [-bd bordercolor] 

[-bg backgroundcolor] [-fg foregroundcolor] [-fn font] [-lfn largefont] [-ib file] [-iconic] 

DESCRIPTION 

The xsnmpmon command invokes a Simple Network Management Protocol (SNMP) network monitor that 
uses the X Window System graphical user interface. This monitor allows you to obtain the status for any 
SNMP-compliant machine on your network. This monitor is normally run on the OWS-E, but it can be run 
on a CRI mainframe. 

The arguments to xsnmpmon are as follows: 

-d display | -display display 

Specifies the name of the terminal on which you want to display the 
network monitor. (You can enter either -d or -display.) The default is 
the current value of the display environment variable. 

-bd bordercolor Specifies the border color of each window within xsnmpmon. You can also 

set this by using the Colors button of the Setup window from within the 
monitor interface. The default is black. 

-bg backgroundcolor Specifies the background color of each window within xsnmpmon. You 

can also set this by using the Colors button of the Setup window from 
within the monitor interface. The default is dimgray. 

- f g foregroundcolor Specifies the foreground color (that is, the color of the text) of each window 

within xsnmpmon. You can also set this by using the Colors button of 
the Setup window from within the monitor interface. The default is 
black. 

- f n font Specifies the normal font. The default is 6 pixels by 13 pixels. 

- 1 f n largefont Specifies the large font, which is used for highlighting text. The default is 6 

pixels by 13 pixels, bold. 

- ib file Specifies the icon bitmap file, which allows you to create your own icon, 
-iconic Starts xsnmpmon in iconic state. 

The monitor consists of a main window (named SNMP Network Monitor) with many buttons; these 
buttons invoke other windows that allow you to set up your monitor environment, control the monitor's 
actions, and perform various functions. To perform an action, place the mouse pointer on top of a button 
(highlighting it) and click any mouse button. You can have several windows open at one time. 

Whenever the program requires you to input text, a dialog window containing a question appears at the top 
of your screen. To perform an action, answer the question and press <RETURN>; to exit from the dialog 
window without changing anything, press <RETURN> without entering text. If you enter inappropriate 
text, the window will exit without making any changes. 
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At the top left corner of the main window is the Setup button, which allows you to change the default 
settings of the program. At the top right corner is the Quit button, which allows you to exit from 
xsnmpmon. Every window contain a Quit button that allows you to exit that function. 

Following the Setup and Quit buttons is a block of 24 buttons. The first 16 buttons in the block 
represent the 16 SNMP MIB-n (Management Information Base) variable groups. Each of these groups 
contains a number of variables that are maintained by all compliant SNMP agents. In this context, 
compliant refers to agents that support the variables as they are defined in the Request for Comment 
documents RFC 1 156 and RFC 1 158. (See the SEE ALSO section.) 

The eight remaining buttons allow you to perform the following functions: display the error log, trap log, 
and state change log; create a network; graphically represent the status of the network; run a performance 
monitor; start up an operator notification window; and use the SunOS telnet(l) command to contact the 
selected SNMP agent (if you are running xsnmpmon on a CRI mainframe, use the UNICOS t elnet(lB) 
command). 

Beneath the block of buttons are lines of synopsis information. As indicated by the text, clicking the left 
mouse button in the main window increases the sampling rate, and clicking the middle mouse button 
decreases it. 

At the bottom of the window is a highlighted line used to display messages from the monitor. Any 
messages from the monitor will be echoed to this line, to standard error, and to a log file. 

The monitor is capable of keeping a log file of all the activity that occurs on a daily basis. By default, the 
log file is named xsnmpmon . log . mmddyy, where mmddyy is the month, day, and year, respectively. At 
midnight on each day, xsnmpmon closes the current day's log file and automatically opens a new log file 
for the new day. You can change the default file name by resetting the SNMP_L0GFILE environment 
variable. If you do not want a log file, set SNMP_LOGF I LE to the following: 

/dev/null 

The following subsections describe each of the buttons in the order in which they appear in the window. 
Setup Button 

The Setup button invokes a window containing several buttons that allow you to modify your monitor 
environment either for this particular session (by clicking on the Done button) or permanently (by clicking 
on the Save button). The lines that follow the buttons show the current settings. The buttons in the 
Setup window, from left to right and top to bottom, are as follows: 

Button Description 

Save Permanently saves the current setup in the xsnmpmon . rc file (or the file specified by 

the SNMP_RCFILE environment variable) and exits from the Setup window. 

Colors Specifies the color of the windows and their contents. All of the current colors are listed 

at the bottom of the Setup window. When you click on Colors, you will be asked if 
you want to use a color palette program; by default, this program is hyperview 
xnewsdemo . hv. If you want to use another color palette program, set the 
snmp_colorprog environment variable to the path name of the program. 

Telnet Specifies a shell command string to use to contact an agent using the telnet(l) 

command. For example, to open an xterm window with 80 columns and 60 rows, set 
jump scrolling, and have the telnet program run in the window, you would enter the 
following in the dialog window: 

xterm -geom 80x60 -j -e telnet 

Bell Turns on/off the bell sound when an error is reported. Each time you click this button, you 

toggle the state of the option. 
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S C Log Turns on/off the logging of state changes. Each time you click on this button, you toggle the 

state of the option. 

Trap Log Turns on/off the logging of trap messages sent from agents to the monitor. Each time you 
click on this button, you toggle the state of the option. 

AutoSkip Turns on/off the ability to skip agents that are not SNMPreachable during network scans. 

When set to YES, only ICMP packets are sent until an SNMP trap is received. When set to 
NO, SNMP packets are sent Each time you click on this button, you toggle the state of the 
option. 

I P Name s Turns on/off the displaying of names for Internet Protocol (IP) addresses. Each time you 
click this button, you toggle the state of the option. 

MI B - 1 1 Turns on/off the use of MD3-II variables when examining SNMP agents; this is useful when 

you are connected to an agent that does not support MIB-II in order to avoid repeated error 
messages and for performance reasons. Each time you click this button, you toggle the 
state of the option. 

Au t o Turns on/off the automatic map loading, scan starting, and pop-up visual symbol event 

notification; this is useful only if the configuration is saved. Each time you click on this 
button, you toggle the state of the option. 

Samp ling Specifies the rate, in seconds, at which the MIB variables are sampled when the statistics 
windows are active. 

Polling Specifies the rate, in seconds, at which the agents are polled during the scanning process; 

that is, the amount of time the monitor waits between the time when it finishes scanning one 
agent and begins scanning the next. For example, if you have 10 agents and you specify 2 , 
it will take about 20 seconds to scan all of them. ( 1 second is the fastest rate allowed.) 

Cy c 1 e Specifies the time, in seconds, that the monitor waits between the time it finishes polling the 

last agent and the time it goes back to the first in the network map. For example, if you have 
10 agents and you specify 2 for polling and 6 0 0 for cycle, every 1 0 minutes a cycle that 
takes about 20 seconds to complete will occur. ( 1 second is the fastest cycle allowed.) 

Agent Connects to a different SNMP agent. If you do not also specify a change for the community 

by using the Commun i ty button, the new agent is assumed to be in the same community as 
the previous agent. 

Comm ' ty Specifies the community for an agent. Use this button when you change to a new agent that 

is in a community different from that of the previous agent. 

Ne t D i r Specifies the directory in which the network files are kept. When a network is created and 

retrieved for the scanning process, the files are assumed to be in the current directory. You 
can also specify the directory by setting the SNMP_NETD I R environment variable. 
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Ne t f i 1 e Specifies the network file, which is the first file the monitor will attempt to load; this file 

represents the area at the highest layer. If you create a network consisting of multiple layers 
or areas, each area is contained in a file by itself; if the network file calls other files that 
represent subareas, the monitor will recursively load all of the files associated with it. For 
example, suppose you have CRI mainframes in computer room A and computer room B . 
You might therefore have three files to describe these areas: site.net, r oomA .net, 
and r oomB . ne t . If you specify site.netas your network file, the monitor will load 
site . net, roomA .net, androomB .net. If you specify roomA . net as your 
network file, it will load only that file, and you will be able to monitor only the network 
described in that file. You can also specify the network file by setting the SNMP_NETF ILE 
environment variable. 

Done Exits the setup mode and invokes the changes made for this xs nmpmon session only. The 

changes are not written to the xs nmpmon . rc file. 

Quit Button 

To exit from xs nmpmon, click the Quit button. Most of the subwindows have a Quit button in the top 
right corner; when clicked on, the function being performed stops and the window closes. 

System Info Button 

The System Info button provides general information about the system (agent) in question. The most 
important part of this window is the list of network interfaces and their current status. Also shown is the 
network to which each of the interfaces is attached. At the bottom of the window there is a line indicating 
how long the agent has been up. This field, along with the status of each of the interfaces, is dynamically 
updated. If the status of an interface should change, it would show immediately in this window. 
Information that is new to MIB-n is the information entitled contact, location, name, and services. This 
information is used to convey the whereabouts of the machine and who the responsible party is. The 
services available on the system are also provided. 

I/F Stats Button 

The I/F stats button dynamically shows the state of each set of variables associated with each 
interface within an agent. Click the left or middle mouse buttons to scan through each of the interfaces. 

Media Stats Button 

This function has not been implemented yet. Statistics unique to different types of media such as Ethernet 
and FDDI (fiber distributed data interface) will be provided here. The MIBs that define these media-specific 
variables are still in the experimental stage; when they are supported by a larger group of vendors, they will 
be supported by this program. 

ICMP Stats Button 

Dynamically displays the state of variables (statistics) associated with Internet Control Message Protocol 
(ICMP) packets that enter and leave the agent. 

IP Stats Button 

Dynamically displays the state of variables (statistics) associated with IP packets that enter and leave the 
agent. 

TCP Stats Button 

Dynamically displays the state of variables (statistics) associated with Transmission Control Protocol (TCP) 
packets that enter and leave the agent. 

UDP Stats Button 

Dynamically displays the state of variables (statistics) associated with User Datagram Protocol (UDP) 
packets that enter and leave the agent. 

EGP Stats Button 

Dynamically displays the state of variables (statistics) associated with Exterior Gateway Protocol (EGP) 
packets that enter and leave the agent. 
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SNMP Stats Button 

Dynamically displays the state of variables (statistics) associated with SNMP packets that enter and leave 
the agent. 

AT Table Button 

Displays the Address Translat ion Table window, which shows the binding between the IP 
address, media address, and interface. Each agent, in order to map from IP addresses to physical addresses, 
uses some mechanism to perform the binding and discovery of these addresses. On media such as Ethernet 
and FDDI, a protocol called Address Resolution Protocol (ARP) is used along with the broadcast feature of 
the medium to derive physical media addresses from IP addresses. On CRI mainframes, for example, a 
static mechanism is used (hy route). If the window displays "More ..." in the bottom right hand 
corner, it indicates that there is more information than would fit on a single screen. To display the rest of 
the information, click any mouse button while the mouse pointer is in the window. 

Net /Media Tbl Button 

This button conveys the same information as the AT Table button if you are connected to an agent that 
supports MIB-II; if you are connected to an agent that supports only MIB-I, you will get an error message. 
You can use this button to determine whether or not an agent supports MIB-II. (In MIB-n, the Address 
Translation Table is listed as deprecated; therefore, this table will replace the Address Translation 
table if there ever is a MlB-ni. However, because they are both part of MIB-n, they are both supported.) 

IP Addr Tbl Button 

Displays each interface's IP address and subnet mask, and the polarity of the least significant bit of the 
broadcast address for the medium. 

IP Route Tbl Button 

Displays the IP routing entries for the agent. The table is organized as follows: destination IP address; the 
interface through which the packets will be routed; the value of the metrics for each route hop; the next hop 
in the route; whether the route is a local or remote route; how the route was learned; and the age of the 
route entry. 

TCP Connection Button 

Displays the state of all the TCP connections to the agent. The table is organized as follows: the state of 
the connection; the IP address within the agent to which the connection applies; the port within the agent to 
which the connection was made; the IP address of the connected entity; and the port number of the 
connected entity. 

UDP Listeners Button 

Displays all of the UDP applications listening within the agent. The table is organized as follows: the IP 
address that is listening and the port number on which it is listening. 

EGP Neigh Button 

Displays information about all of the agent's EGP neighbors. 

FDDI SMT Button 

Displays all of the station management parameters for a given station management (SMT) entity in an FDDI 
station. 

FDDI MAC Button 

Displays all of the media-access control (MAC) parameters for a given media-access control entity in an 
FDDI station. 

FDDI Port Button 

Displays all of the port parameters for a given port entity in an FDDI station. 

FDDI Attach Button 

Displays all of the attachment parameters for a given attachment entity in an FDDI station. 
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Error Log Button 

Displays the error log. When the monitor makes an SNMP request to an agent, and the request terminates 
with abnormal status, the event is logged in the error log. Each error is date- and time-stamped before 
being placed into the log. The error log keeps the last 50 errors; when the 51st error occurs, it over- writes 
the first error logged. A marker (>) is placed next to the last error logged to help you quickly locate the 
newest error. 

Trap Log Button 

Displays all of the acknowledged traps as normal text and the unacknowledged traps as warning text. One 
of the features of the SNMP protocol is the concept of a trap. A trap is an unsolicited message that can be 
sent from an agent to a client (application) whenever a significant event occurs within the agent. For 
example, when the agent reboots or when an interface changes states within the agent, a trap message 
would be sent. Each time a trap message is received by the monitor, it is date- and time-stamped before 
being placed into the trap log. This display shows the last 50 traps received. Because a trap from an agent 
can be an event that indicates the need for human intervention, when the trap is received it is marked as 
unacknowledged. The unacknowledged trap will remain in a warning state until you select the entry by 
clicking the left mouse button on it, at which time it will become highlighted; you can select multiple traps. 
When you have a trap selected, acknowledge it by clicking the right mouse button or cancel the select on 
that entry by clicking the middle button. One click of the right mouse button acknowledges all of the 
selected traps. If the trap log fills up with unacknowledged traps, new traps are sent to the log file but are 
not placed into the trap log. 

State Chg Log Button 

Displays the state change log. Whenever the status of an agent or one of its interfaces changes from one 
poll cycle to the next, an entry is made in the state change log. The color of the message as it appears in 
the window will be something other than the normal text color. It will stay this way until you acknowledge 
it. Select an entry by clicking the left mouse button on it, at which time it will become highlighted; you can 
select multiple entries. When you have selected the state change entry, acknowledge it by clicking the 
right mouse button or cancel the select on that entry by clicking the middle button. One click of the right 
mouse button acknowledges all of the selected entries. When the state change log fills up, the network scan 
will be automatically stopped. (This button does not work on monochrome displays.) 

Create Net Button 

Invokes a tools that allows you to create the network files used in the scan process. When you click this 
button, a subwindow containing several buttons and a map area opens at the top of your screen. To create 
a network configuration, click the button that describes the object you wish to create, and move the mouse 
pointer down into the map portion of the window; at this point, the mouse pointer becomes a pencil. Click 
the left mouse button to create the object. In most cases, the program will ask for some basic information 
about the object being created (such as a name) by using a dialog window. When you enter the text and 
press <RETURN>, the dialog window disappears and the object appears in the map. You can place the 
object wherever you wish by moving it with the mouse. When the object is in the desired position, click 
the left mouse button to place the object there. 

The buttons in the Create Network Configuration window, from left to right, are as follows: 
Button Description 

Area Creates and names an area, which provides a layered effect in the network map. An area 

can be thought of as a room, building, city, network, and so on. It is completely up to 
you to decide how to represent your network to the monitor. The figure for an area is a 
trapezoid. You are asked to provide a name and description for the area. When you 
have moved the figure where you want it on the map, click the left mouse button to place 
it there. 
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Agent 



Interface 



Bus 



Ring 



Link 



Connector 



Label 



Creates and names an agent, which is any SNMP-manageable entity. That is, an agent 
can be a host, gateway, router, or any other box that has an SNMP agent running in it. 
An agent is represented by a rectangular figure. You are asked to enter the name of the 
agent in a dialog window. This name must be a name that appears in the /etc /host s 
file. (If the program cannot resolve the IP address of the agent from the name given, you 
will be asked to enter the IP address.) Next, you are asked to enter the SNMP community 
string to be used when conversing with this agent. Finally, you should provide a 
description of the agent, such as "NSC IP router." When you have moved the figure 
where you want it on the map, click the left mouse button to place it there. 

Creates and names an interface. An interface connects an agent to a network. On the 
map, a line or set of line segments represents a physical network interface. To create an 
interface, the line representing the interface must touch the agent and the network to 
which the agent is connected. Because the interface can be drawn as a series of line 
segments, click the left mouse button to start the line and change its direction. To 
complete the line, click the middle or right mouse button. When your drawing is 
complete, the monitor automatically searches for the number of the interface; if it cannot 
find the number, the monitor asks you to enter the number in the dialog box. You can 
find the number of the interface by connecting to the agent and displaying the System 
In format ion window. The left-most column shows the interface numbers (or 
indexes). 

Creates and names a bus. A bus is a network topology in which all of the nodes connect 
to one wire. Examples of bus-type network media are Ethernet and HYPERchannel. A 
bus is represented by a line or set of line segments. Because the bus can be drawn as a 
series of line segments, click the left button to start the line and change its direction. To 
complete the line, click the middle or right mouse button. If the name you entered does 
not appear in the /etc/networks file, the program will also ask you to provide the 
bus's IP address. When your drawing of the bus is complete, you will be prompted to 
place the name, IP address, and description of the bus on the map. 

Creates and names a ring. A ring is a network topology in which all of the nodes 
connect together in a closed loop. Examples of ring networks are FDDI and TOKEN 
Ring. A ring is represented on the map by an ellipse. Click the left mouse button to 
place the center of the ring on the map. You can change the size of the ring by dragging 
the mouse in any direction. Click the left mouse button a second time to affix the ring to 
a certain spot on the map. If the name you entered does not appear in the 
/etc/networks file, the program will also ask you to provide the ring's IP address. 
When your drawing of the ring is complete, you will be prompted to place the name, IP 
address, and description of the ring on the map. 

Creates and names a link. A link is a network topology that involves a local and remote 
side, usually point-to-point in nature. Tl, T3, and satellites are examples of link media. 
A jagged line (similar to a lightning bolt) represents a link on the map. Clicking the left 
mouse button starts and ends the link. If the name you entered does not appear in the 
/etc/networks file, the program will also ask you to provide the link's IP address. 
When your drawing of the link is complete, you will be prompted to place the name, IP 
address, and description of the link on the map. 

Creates a dot that represents a physical connection to a network. To affix the connector 
on the map, click the left mouse button. 

Creates a label, which is a text string that can be placed any where on the network 
picture. These are essentially comments and should be used to make notes as needed on 
the network drawing. Click the left mouse button to affix the label to the map. 
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Delete Deletes objects on the map. To delete, click the De 1 e t e button, place the pencil cursor 

inside the object, click the left mouse button to highlight the object, and click the left 
mouse button to delete the object; if you do not want to delete the object, click the right 
mouse button to cancel the operation. 

Move Moves objects on the map. To move an object, click the Move button, place the pencil 

cursor inside the object, click the left mouse button to highlight the object, move it 
where you want it to be, and click the left mouse button to affix the object to its new 
spot; if you do not want to move the object, click the right mouse button to cancel the 
operation. 

Load Loads an existing file in order to modify it, delete it, or copy to a different file name. 

Save Saves the map to a disk file for late retrieval. 

clear Clears the current map. If you have made changes to the map and have not clicked the 

Save button, you will be prompted to save or clear the map. 

Redraw Refreshes the contents of the window. 

Grid Turns on/off a grid of lines that is helpful when you are drawing and placing objects on 

the map. Each time you click this button, you toggle the state of the option. 

Assist Accesses the assist file, which defines a layered network topology to the xs nmpmon 

drawing facility. This allows you to specify a general view of the network to 
xsnmpmon, which in turn uses SNMP and the /etc/networks and /etc/hosts 
files to obtain information about the network. 

Net Status Button 

Displays a subwindow that contains the following buttons, from left to right: 



Button 

Start 

Stop 

Restart 

Load 
Route 



Description 

Starts the polling sequence from the beginning. Any previous status is cleared. 

Stops the polling sequence, but retains the previously obtained status. 

Restarts the polling sequence from where it left off (when the stop button was clicked 
on). 



Loads a new network configuration. 

Performs a route trace. To show the route taken to connect the source agent to the 
destination agent and back again, click the left mouse button on the source and the right 
mouse button on the destination. The route from the source agent to the destination will 
appear in cyan (by default); the route from the destination back to the source will appear 
in tan (by default). You can also use this to perform a route trace between two specific 
interfaces for agents with multiple interfaces. When you have performed all of the route 
traces desired, click Restart to resume the network scan from where you left off (the 
same colors reappear), or click start to start from the beginning. 

A color legend is also located at the top of the window. Each agent is polled to determine its status and the 
status of the defined network interfaces. Although you may modify these colors, the following shows the 
defaults for each. 
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Agent status is represented by one of the following colors: 

Color Description 

White Untested 

Blue Scanning 

Yellow Reachable by ICMP but not responding to SNMP requests 

Red Not reachable or down 

Green Up 

Interface status is represented by one of the following colors: 

Color Description 

White Untested 

Blue Scanning 

Yellow Unknown 

Magenta Testing 

Orange Misconfigured 

Red Down 

Green Up 
Area status is represented by one of the following colors: 

Color Description 

White Untested 

Blue Scanning 

Yellow Problem 

Green OK or unknown 

During the network scan process, xsnmpmon accesses two files: an action file (xsnmpmon . act) and an 
exception file (xsnmpmon . xcp). The xsnmpmon . act action file is consulted whenever a trap is 
received or a state change event occurs during a network scan. If an event occurs that is registered in the 
action file, a shell script (named in the action file) will be executed. The triggering events can range from 
quite general to very specific. Shell scripts can be tailored to perform any necessary action, such as calling 
a pager or sending an electronic mail message to a network administrator. 

The exception file is accessed from the Network Status (scan phase) window and can be used to 
prevent the polling of agents or interfaces that are known to have problems or do not support SNMP. This 
file can also be used to force polling of agents that do not support SNMP; normally, when the network scan 
detects an agent that it can reach by using ICMP but not SNMP, it stops polling that agent until an SNMP 
trap is received from it. 

During the polling sequence, each agent is sent an SNMP request to determine its status. If the monitor 
does not get an answer from the SNMP request, it then tries to reach the agent using an ICMP ECHO request. 
If this is unsuccessful, the agent's status is set to "unreachable." All agents that are set to unreachable are 
polled each polling cycle, unless the exception file is used (the exception file, xsnmpmon . xcp, can be 
used to prevent the polling of agents or interfaces that are known to have problems or that do not support 
SNMP. This file can also be used to force the polling of agents that do not support SNMP.) If the ICMP 
request is successful, the status of the agent is set to "ICMP reachable" and that agent will not be polled 
again. This usually indicates that there is no SNMP agent within that agent or that it is down. When the 
SNMP agent becomes active, it should send a trap message to the monitor, at which time the agent will be 
placed back into the polling list. 
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If during the scan the state change log becomes full of unacknowledged state changes, the scan is stopped 
automatically. You must acknowledge the state changes and manually restart the scan by clicking on the 
Restart button. 

The mouse buttons have actions assigned to them in the network status window also. If you place the 
cursor inside an agent and click the left mouse button, the monitor attempts to connect the monitor to that 
agent. (This has the same effect as using the Agent button in the Setup window). If successful, the 
main window is raised to the top of the window stack and you can use the other features of the monitor to 
view variables within the agent. 

Use the middle mouse button to traverse the layers of the map. To go inside of an area (that is, to go down 
a layer), place the cursor inside the area figure and click the middle mouse button. To move up through the 
layers, place the cursor anywhere except inside an area figure and click the middle mouse button. If you 
place the cursor inside an agent or area and click the right mouse button, you will get a summary of that 
object. In the case of agents, the name, community, description, IP address, and list of interfaces will be 
shown. In the case of an area, the area's name and description is given as well as a summary of the status 
of all of the sub-areas, agents, and interfaces within that area is given. 

When you click the Route button, use the left button to specify the source agent and the right button to 
specify the destination. 

The status of an area is meant to represent the status of that entire area. An area is considered to have a 
problem if any agents within the area are unreachable or reachable only with ICMP or if any interfaces are 
down. 

Perf Monitor Button 

Displays a graphical representation of selected variables within the interface set of statistics and a separate 
graph of the ICMP turnaround time. ICMP turnaround time is the time it takes to get a minimum-size ICMP 
packet from the monitor station to the connected agent. This information can be helpful in solving 
problems related to network latency (such as TCP window size and other tuning issues). 

Notification Button 

Displays visual symbols that indicate when human intervention is required. As trap messages are received 
from the network, this window indicates that there are potential problems occurring in the network by 
changing the color of the trap message light. Similarly, if an agent or an agent's interface changes states 
from one poll to the next, the state change light changes color. 

Telnet Button 

Executes the shell command defined in the . rc file as the telnet string. Typically, clicking on this 
button causes a telnet session to be started with the specified agent. 

ENVIRONMENT 

Your PATH must contain /usr/bin/Xll in order to run xsnmpmon. Environment variables are 
checked only when the program is started. The following shell environment variables are used: 

MIBFILE Path to the text file used by the client created by Carnegie-Mellon 

University for the MIB specification. The default is mib . txt in the current 
working directory, or else /etc/mib . txt. 

SNMP_BADVARTY P When set to equal ignore, this tells xsnmpmon to ignore variable-type 

error messages. It is useful when you know that a particular agent is 
returning bad variable types, and you want to avoid the numerous variable- 
type error messages that it may send. 

SNMP_ACTI0NFILE Path name of the action file. The default is xsnmpmon . act in the current 

working directory. 

SNMP_ASSISTFILE Path name of the assist file. The default is xsnmpmon . ast in the current 

working directory. 
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SNMP_EXCEPTIONFILE 



SNMP_COLORPROG 



Path name of the color palate program. The default is xnewsdemo . hv. 
(When run on a CRI mainframe, this variable is set to null by default.) 

Path name of the exception file. The default is xsnmpmon . xcp in the 
current working directory. 



SNMP_LOGF I LE 



Path name of the log file. The default is xsnmpmon . log . mmddyy 
(month, day, year) in the current working directory. 



SNMP_RCFILE 



Path name of the resource ( . rc) file. The default is xsnmpmon . rc in the 
current working directory. 



FILES 



xsnmpmon . log 



xnewsdemo . hv 



Default color palate program (except when run on a CRI mainframe) 
Default log file 



xsnmpmon . rc 



Default resource file 



/etc/hosts 



IP names and addresses of all the hosts on the network 



/etc /networks 



IP names and addresses of all the networks on the network 



/etc /services 



IP port numbers and protocols on the network 



BUGS 



The sizes of the windows are fixed within the program and cannot be resized by the window manager. 

If you move agents or networks within the Create Net window, the interfaces to which they were 
connected are not moved. 

If multiple xsnmpmon sessions are run on a single station, only the first invoked will receive traps. 
EXAMPLES 

One example of how the monitor may be used to detect and troubleshoot a network problem is as follows. 

The operator invokes the program by entering xsnmpmon at a window and starts up the network scan 
function by clicking on the Net Status button. When the network scan function is running, the 
operator closes this window (leaving the scan running) and opens the Notification window by 
clicking on the Not i f icat ion button. Then the operator iconifies the main window. 

As the network scan continues, one of the interfaces of one of the agents changes states from up to down. 
When this is detected by the monitor, a number of things occur. First, a record of this event is indicated by 
a message in the logfile (and standard error). Next, the event is logged in the state change log and marked 
as unacknowledged. When this occurs, the state change event indicator in the event notification window 
changes from its "off color (normally green) to its "on" color (normally red), which indicates to the 
operator that some intervention is required. 

When the operator sees this indicator turn on, he or she opens the main window and clicks on the state 
Chg Log button to open the State Change Log window. A record of the event is indicated by the 
greater-than sign (">") and also the color of the message. The message reads as follows: 

DD/MM/YY HH:MM:SS 128.162.25.3 (hostname) I/F 3 changed from UP to DOWN 

This message tells the operator that interface number 3 in box 128 .162.25.3 has gone down. At this point, the 
operator should contact the system administrator or network analyst. 
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The administrator would then click the Net Status button to bring up the Network Status window so 
that he or she could find the relevant box in the network diagram. Once found, the administrator would look at 
all of the other interfaces in that box to see if they are still up. Also, he or she may want to look at interfaces in 
other boxes connected to the same network to determine what state they are in. 

If it looks like this is the only interface that is having a problem, the administrator may want to connect to that 
box and begin examining other information to see if the reason why this interface has gone down can be 
determined. By placing the pointer inside of the agent' s icon and clicking on the left mouse button, the 
administrator directs the monitor to attempt to connect to that agent. Once connected, the administrator may 
open up the interface statistics window and click the left or middle mouse buttons until the window is 
displaying statistics for interface number 3. Once the proper set of statistics is being displayed, the first thing 
that the administrator should look at is the administrative status field to see if it says up or down. If it says 
down, the administrator now knows that the interface went down because someone has taken it down. If the 
administrative status says up, then the administrator knows that the interface was not intentionally taken down 
but has gone down for some other reason. 

At this point, the administrator may want to use the t e 1 ne t command to contact the box to see if he or she can 
restart the interface manually. To do this, the administrator clicks on the Te lne t button and logs into the box. 

At this point, the monitor' s job has been completed; ithas detected and notified the system staff that an 
interface out on the network has gone down and assisted them in determining that the interface either was or 
was not supposed to be down. When the administrator has corrected the problem, he or she should click the 
State chg Log button to go back into the state change log and acknowledge the relevant log entry so as not 
to be alerted by it in the future. 

SEE ALSO 

telnet(l) or telnet(lB) for information about the SunOS or UNICOS command, respectively, for the 
user interface to a remote system using the TELNET protocol 

xterm(l) for information about the SunOS command for the terminal emulator for the X Window System 

OWS-E Operator Workstation Administrator's Guide, publication SG-3079, and OWS-E Operator 
Workstation Operator's Guide, publication SG-3078, for more information about CPU monitors. 

The Simple Book, An Introduction to the Management of TCP/IP-based Internets by Marshall T. Rose. 
Prentice-Hall, Inc. Englewood Cliffs, New Jersey, 1991. 

The following Request for Comment (RFC) documentation: 
SNMP over Ethernet, RFC 1089 
Structure of Management Information, RFC 1155 
Management Information Base (MIB-I), RFC 1156 (Obsoleted 1066) 
SNMP Protocol, RFC 1157 (Obsoleted 1098) 
Management Information Base II (MIB-II), RFC 1 158 
Bulk Table Retrieval using SNMP, RFC 1 187 

The following American National Standards Institute (ANSI) documentation: 

Fiber Distributed Data Interface (FDDI) Token Ring Physical Layer Medium Dependent (PMD), 
X3.166-1990 

Fiber Distributed Data Interface (FDDI) Token Ring Physical Layer Protocol (PHY), X3. 148-1988 
Fiber Distributed Data Interface (FDDI) Token Ring Media Access Control (MAC), X3. 139-1987 
FDDI Station Management, X3T9/90-X3T9 .5/84-49 Rev 6.2 (draft) 

Internet Draft FDDI Management Information Base (MIB) 
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NAME 

z ip - Acts as the terminal interface to a running CPU 
SYNOPSIS 

/home/foca/fto^/cri/bin/zip [-C] [-D] 
/home//0ca//j05f/cri/bin/zip [-D] [line] 

DESCRIPTION 

The z ip program works as the terminal interface to a running CPU. You should use the z ip program as a 
console and to talk to an IOP if the network is not up. 

If you specify z ip without -C or line, it will enter command mode, indicated by the z ip> prompt. If you 
use line, z ip will perform an open built-in command on that line. If you enter -C, z ip will open line 0 
(the UNICOS console line). After z ip establishes a connection with the CPU, it enters input mode. 
Characters are sent to the CPU for processing and echoed back to the OWS-E. 

The arguments to zip are as follows: 

-C Connects to the UNICOS console. This is equivalent to entering 0 for line; if you enter -c, you 

cannot specify a value for line. 

-D Specifies debug mode for the z ip program and sends the output to standard error. 

line Specifies the line upon which z ip performs an open built-in command. The value specified 

for line can be an integer from 0 through 4; 0 specifies the UNICOS console, which is 
equivalent to entering the -C option (you cannot specify both -c and line). 

BUILT-IN COMMANDS 

The z ip program contains the following built-in commands (you are required to enter only the first letter 
of each): 

c [ 1 o s e] Closes a connection to a device. 

d[ebug] Enables or disables zip debug statements. 

e[scape] Changes the escape sequence used in z ip. When you enter this built-in command, 

you are prompted for a new escape character sequence. 

NOTE: The default escape sequence is ~ ] (that is, press the <CONTROL> 
key and then the ] key). Because this is the same as the telnet default 
escape sequence (" ] ), you cannot escape from zip without destroying 
your telnet session unless you change the zip sequence with escape. 

o[pen ] [line] Opens a connection to the specified line, line can be set to an integer; 0 specifies 

the UNICOS console. If you do not enter line, z ip will find the first line available, 
beginning with line 1; if all lines are busy, it will then check the console line (line 
0). If you do not request a specific line and all lines are busy, the line held by a 
user with a lower priority than yours will be usurped if usurp mode has been 
toggled on. If you request a specific line and that line is busy, the line will be 
usurped from the present owner if he or she has a priority lower than yours and if 
usurp mode has been toggled on. The location of the line-arbitration priority file 
is specified by the LAPFILE parameter in /etc/conf igf i le; by default, 
LAPFILE is set to /etc/lapf ile. 

q[ui t] Closes any existing connections and exits z ip. 
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r[oute] cluster Changes the route through an alternative cluster; the range of valid cluster 

numbers depends on the number of clusters in the IOS-E. If you do not enter a 
value for cluster, you will be prompted for one. 

s [tatus] Displays the line to which you are connected, the route, and the escape sequence. 

u[surp] [reason] Toggles usurp mode. If usurp mode is turned on when you execute the open 

built-in command, zip will usurp (take away) a t ty line currently being used by 
someone else if you have a higher priority level (specified in the line-arbitration 
priority file) than that person. The location of the line-arbitration priority file is 
specified by the LAPFILE parameter in /etc/conf igf ile; by default, 
LAPFILE is set to /etc/ lapf i le. The higher the number specified, the 
higher the priority of the user. By default, all users have a priority of 0; that is, no 
priority, which means that they cannot usurp a tty line. 

reason is the reason the line is being usurped; this reason is sent to the usurped 
user. Quotation marks are optional, even if the reason contains white space. 
reason is truncated after 79 characters, not including quotation marks (a longer 
reason will not cause an error, but the 80th and succeeding characters will not be 
used). 

If a tty line that you are using is usurped by another user, you can try to borrow 
it again when the usurper has finished with it. 

z Suspends a z ip process. There can be only one process running in a device at a 

time; if you suspend a process with z, no one else can access the device. 

? Displays help for z ip. 

Permission to access this built-in command is set in /etc/owsepermf ile by the system administrator. 
EXAMPLES 

The following example opens a connection through line 3 to the CPU: 

zip 3 

The following example shows a z ip session (the bold text indicates user input). 
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machine% zip 
zip> status 

NOT connected to mainframe 
Routed via mux, cluster 0 
Escape character is '"]' 

zip> escape 

new escape character: <control>~ ##Press the control key- 
Escape character is ' ~ [ ' 
zip> open 2 



Connected to mainframe via 2 
Routed via mux, cluster 0 
Escape character is ' ~ [ ' 

login : ~ [ 
zip> close 
Connection closed 
zip> status 



##To escape back to zip 
##To close the connection 



NOT connected to mainframe 
Routed via mux, cluster 0 
Escape character is 

zip> quit 
machine% 



CONFIGURATION FILE PARAMETERS 

The zip command reads the following parameters from /etc/conf igf ile: 

LAPFILE Specifies the location of the line-arbitration priority file used by lapdaemon(8). 

Default: 

/etc/lapf ile 

FILES 

/etc/owsepermf ile Permissions file that contains a list of accounts and the commands they are 

allowed to access 

/etc/1 ap file Default line arbitration priority file 

/etc/conf igf ile Default configuration file 

SEE ALSO 

telnet(l) for information about the SunOS command that invokes the user interface to a remote system, 
using the TELNET protocol 

conf igf ile(5) and OWS-E Operator Workstation Administrator's Guide, publication SG-3079, for 
information about /etc/conf igf ile 

owsepermf i le(5) for information about the default OWS-E permission file 
lapdaemon(8) for information about the line arbitration priority daemon 
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FUNCTIONAL INDEX 



Acts as the terminal interface to a running CPU Acts as the terminal interface to a running CPU zip(8) 127 

An overview of the OWS-E commands An overview of the OWS-E commands owse_overview(7) . 23 

Arbitration file Default line arbitration priority file lapfile(5) 19 

autodump Controls the automatic dumping of the mainframe 

and the IOS-E autodump(8) 25 

Automatic dumping Controls the automatic dumping of the mainframe 

and the IOS-E autodump(8) 25 

Backing up log files Creates new errlog and ioplog files while 

backing up the existing ones newlog(8) 105 

Backups Performs a full (level-0) backup of the OWS-E 

file systems dumpwkly(8) 41 

Backups Performs an incremental (level-9) backup of the 

OWS-E file systems dumpdly(8) 37 

Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

Boots one or more IOPs from the OWS-E Boots one or more IOPs from the OWS-E eboot(8) 42 

Boots the IOS-E and the mainframe Boots the IOS-E and the mainframe bootsys(8) 26 

bootsys Boots the IOS-E and the mainframe bootsys(8) 26 

Checks IOP status Checks IOP status estat(8) 74 

Commands overview An overview of the OWS-E commands owse_overview(7) . 23 

Complete backups Performs a full (level-0) backup of the OWS-E 

file systems dumpwkly(8) 41 

Configuration file Default OWS-E configuration file configfile(5) 14 

Configures a MUXIOP high-speed channel up or down ... Configures a MUXIOP high-speed channel up or 

down hcon(8) 92 

Configures a MUXIOP-to-EIOP low-speed channel up 

or down Configures a MUXIOP-to-EIOP low-speed channel up 

or down econ(8) 45 

Console Acts as the terminal interface to a running CPU zip(8) 127 

Controls the automatic dumping of the mainframe 

and the IOS-E Controls the automatic dumping of the mainframe 

and the IOS-E autodump(8) 25 

Controls the fy driver Controls the fy driver fyadmin(8) 77 

conv Converts a file from old edump file format to 

new edump file format conv(8) 30 

Converts a file from old edump file format to new 

edump file format Converts a file from old edump file format to 

new edump file format conv(8) 30 

CPU register dumping Dumps the mainframe memory and CPU registers to 

a CRI disk on the IOS-E mfdump(8) 97 

CPU time statistics Displays CPU time statistics in graphical form graphs(8) 88 

CPU time statistics Gathers data and disperses CPU time statistics cpud(8) 31 

cpud Gathers data and disperses CPU time statistics cpud(8) 31 

cpudump Forces a UNICOS dump cpudump(8) 32 

cpuhalt Issues a CPU master clear to stop the mainframe cpuhalt(8) 33 

cpupanic Takes a UNICOS panic dump cpupanic(8) 34 

craymon Monitors the mainframe status and sets the OWS-E 

background color craymon(8) 35 

Creates new errlog and ioplog files while backing 

up the existing ones Creates new errlog and ioplog files while 

backing up the existing ones newlog(8) 105 

Daily backups Performs an incremental (level-9) backup of the 

OWS-E file systems dumpdly(8) 37 

Deadstart Boots one or more IOPs from the OWS-E eboot(8) 42 

Deadstart Starts the mainframe CPUs from the OWS-E mfstart(8) 103 
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Default line arbitration priority file Default line arbitration priority file lapfile(5) 19 

Default OWS-E configuration file Default OWS-E configuration file configfile(5) 14 

Default OWS-E permissions file Default OWS-E permissions file owsepermfile(5) 21 

Detects and isolates network problems with the 
OLNET on-line diagnostic network communications 

tool Detects and isolates network problems with the 

OLNET on-line diagnostic network communications 

tool olnet(8) 106 

Displays CPU time statistics in graphical form Displays CPU time statistics in graphical form graphs(8) 88 

dumpdly Performs an incremental (level-9) backup of the 

OWS-E file systems dumpdly(8) 37 

Dumping UNICOS Takes a dump image of UNICOS dumpsys(8) 38 

Dumps an IOP in the event of an IOP failure Dumps an IOP in the event of an IOP failure iophalt(8) 94 

Dumps IOS-E IOP local memory images to the OWS-E .. Dumps IOS-E IOP local memory images to the 

OWS-E edump(8) 64 

Dumps the mainframe memory and CPU registers to a 

CRI disk on the IOS-E Dumps the mainframe memory and CPU registers to 

a CRI disk on the IOS-E mfdump(8) 97 

dumpsys Takes a dump image of UNICOS dumpsys(8) 38 

dumpwkly Performs a full (level -0) backup of the OWS-E 

file systems dumpwkly(8) 41 

eboot Boots one or more IOPs from the OWS-E eboot(8) 42 

econ Configures a MUXIOP-to-EIOP low-speed channel up 

or down econ(8) 45 

ediag Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

edump Dumps IOS-E IOP local memory images to the 

OWS-E edump(8) 64 

edump file format Converts a file from old edump file format to 

new edump file format conv(8) 30 

ehalt Halts one or more IOPs from the OWS-E ehalt(8) 68 

emon Restarts the IOS-E error-logging, heartbeat, 

SMARTE, and CPU monitors emon(8) 70 

eping Sends an echo packet to an IOP from the OWS-E eping(8) 71 

errlogd IOS-E hardware error-logging daemon errlogd(8) 73 

Error logging daemon IOS-E hardware error-logging daemon errlogd(8) 73 

Error logging monitor (restarting) Restarts the IOS-E error-logging, heartbeat, 

SMARTE, and CPU monitors emon(8) 70 

estat Checks IOP status estat(8) 74 

/etc/configfile Default OWS-E configuration file configfile(5) 14 

/etc/lapfile Default line arbitration priority file lapfile(5) 19 

/etc/owsepermfile Default OWS-E permissions file owsepermfile(5) 21 

File format Converts a file from old edump file format to 

new edump file format conv(8) 30 

Forces a UNICOS dump Forces a UNICOS dump cpudump(8) 32 

Formats raw trace buffer information extracted 

from fy driver modules Formats raw trace buffer information extracted 

from fy driver modules fyformat(8) 83 

Full backups Performs a full (level-0) backup of the OWS-E 

file systems dumpwkly(8) 41 

fy driver (controlling) Controls the fy driver fyadmin(8) 77 

fyadmin Controls the fy driver fyadmin(8) 77 

fyformat Formats raw trace buffer information extracted 

from fy driver modules fyformat(8) 83 

fyroute Sets or displays the fy driver's IP Interface 

Routing table fyroute(8) 84 

Gathers data and disperses CPU time statistics Gathers data and disperses CPU time statistics cpud(8) 31 

getconfig Retrieves system parameter values from the 

system configuration file getconfig(8) 87 

graphs Displays CPU time statistics in graphical form graphs(8) 88 



SR-3077 2.0 



132 



Cray Research, Inc. 



Halts one or more IOPs from the OWS-E Halts one or more IOPs from the OWS-E ehalt(8) 68 

Hardware error logging daemon IOS-E hardware error-logging daemon errlogd(8) 73 

hbeat Monitors the IOS-E system hbeat(8) 90 

hcon Configures a MUXIOP high-speed channel up or 

down hcon(8) 92 

Heartbeat monitor (restarting) Restarts the IOS-E error-logging, heartbeat, 

SMARTE, and CPU monitors emon(8) 70 

Incremental backups Performs an incremental (level-9) backup of the 

OWS-E file systems dumpdly(8) 37 

Interface Routing table (setting) Sets or displays the fy driver's IP Interface 

Routing table fyroute(8) 84 

Internet address mapping Sets or displays the fy driver's IP Interface 

Routing table fyroute(8) 84 

Invokes the SNMP network monitor Invokes the SNMP network monitor xsnmpmon(8) 115 

IOP booting Boots one or more IOPs from the OWS-E eboot(8) 42 

IOP dump Dumps an IOP in the event of an IOP failure iophalt(8) 94 

IOP failure Dumps an IOP in the event of an IOP failure iophalt(8) 94 

IOP halting Halts one or more IOPs from the OWS-E ehalt(8) 68 

iophalt Dumps an IOP in the event of an IOP failure iophalt(8) 94 

IOS olebpw Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

IOS olelmr Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

IOS olelmw Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

IOS olemal Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

IOS oleoff Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

IOS oleorr Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

IOS oleorw Boots deadstart diagnostic tests (dsdiag or 

cleario) into one or more specified IOPs ediag(8) 61 

IOS status Checks IOP status estat(8) 74 

IOS-E booting Boots the IOS-E and the mainframe bootsys(8) 26 

IOS-E dumping (automatic) Controls the automatic dumping of the mainframe 

and the IOS-E autodump(8) 25 

IOS-E error-logging monitor (restarting) Restarts the IOS-E error-logging, heartbeat, 

SMARTE, and CPU monitors emon(8) 70 

IOS-E hardware error-logging daemon IOS-E hardware error-logging daemon errlogd(8) 73 

IOS-E initialization and confidence test Runs a mainframe and IOS-E initialization and 

confidence test mfinit(8) 101 

IOS-E local memory dumping Dumps IOS-E IOP local memory images to the 

OWS-E edump(8) 64 

IOS-E monitor Monitors the IOS-E system hbeat(8) 90 

Issues a CPU master clear to stop the mainframe Issues a CPU master clear to stop the mainframe cpuhalt(8) 33 

lapdaemon Validates CRI tty lines for users lapdaemon(8) 96 

Line arbitration file Default line arbitration priority file lapfile(5) 19 

Line-arbitration priority daemon Validates CRI tty lines for users lapdaemon(8) 96 

Looking at memory Peeks (looks) at memory peek(8) 109 

Mainframe booting Boots the IOS-E and the mainframe bootsys(8) 26 

Mainframe dumping (automatic) Controls the automatic dumping of the mainframe 

and the IOS-E autodump(8) 25 

Mainframe initialization and confidence test Runs a mainframe and IOS-E initialization and 

confidence test mfinit(8) 101 

Mainframe memory dumping Dumps the mainframe memory and CPU registers to 

a CRI disk on the IOS-E mfdump(8) 97 

Mainframe starting Starts the mainframe CPUs from the OWS-E mfstart(8) 103 

Mapping internet addresses Sets or displays the fy driver's IP Interface 

Routing table fyroute(8) 84 
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mfdump Dumps the mainframe memory and CPU registers to 

a CRI disk on the IOS-E mfdump(8) 97 

mfinit Runs a mainframe and IOS-E initialization and 

confidence test mfinit(8) 101 

mfstart Starts the mainframe CPUs from the OWS-E mfstart(8) 103 

Monitoring the SNMP network Invokes the SNMP network monitor xsnmpmon(8) 115 

Monitors the IOS-E system Monitors the IOS-E system hbeat(8) 90 

Monitors the mainframe status and sets the OWS-E 

background color Monitors the mainframe status and sets the OWS-E 

background color craymon(8) 35 

Monitors the OWS-E system for SMARTE Monitors the OWS-E system for SMARTE smdemon(8) 112 

MUXEIOP-to-EIOP low-speed channel (configuring) Configures a MUXIOP-to-EIOP low-speed channel up 

or down econ(8) 45 

MUXIOP high-speed channel configuration Configures a MUXIOP high-speed channel up or 

down hcon(8) 92 

Network monitor (SNMP) Invokes the SNMP network monitor xsnmpmon(8) 115 

newlog Creates new errlog and ioplog files while 

backing up the existing ones newlog(8) 105 

olnet Detects and isolates network problems with the 

OLNET on-line diagnostic network communications 

tool olnet(8) 106 

OWS-E Checks IOP status estat(8) 74 

owse_overview An overview of the OWS-E commands owse_overview(7) . 23 

Panic dump Takes a UNICOS panic dump cpupanic(8) 34 

peek Peeks (looks) at memory peek(8) 109 

Peeks (looks) at memory Peeks (looks) at memory peek(8) 109 

Performs a full (level-0) backup of the OWS-E 

file systems Performs a full (level-0) backup of the OWS-E 

file systems dumpwkly(8) 41 

Performs an incremental (level-9) backup of the 

OWS-E file systems Performs an incremental (level-9) backup of the 

OWS-E file systems dumpdly(8) 37 

Permissions to usurp Validates CRI tty lines for users lapdaemon(8) 96 

Ping (eping) Sends an echo packet to an IOP from the OWS-E eping(8) 71 

poke Pokes (places) a pattern into memory poke(8) 1 10 

Pokes (places) a pattern into memory Pokes (places) a pattern into memory poke(8) 1 10 

Priority file Default line arbitration priority file lapfile(5) 19 

Processes service requests from the mainframe 

(IOS-E remote CPU daemon) Processes service requests from the mainframe 

(IOS-E remote CPU daemon) rcpud(8) 1 1 1 

Putting patterns into memory Pokes (places) a pattern into memory poke(8) 110 

Quick-reference to commands An overview of the OWS-E commands owse_overview(7) . 23 

rcpud Processes service requests from the mainframe 

(IOS-E remote CPU daemon) rcpud(8) Ill 

Remote CPU daemon Processes service requests from the mainframe 

(IOS-E remote CPU daemon) rcpud(8) 1 1 1 

Restarts the IOS-E error-logging, heartbeat, 

SMARTE, and CPU monitors Restarts the IOS-E error-logging, heartbeat, 

SMARTE, and CPU monitors emon(8) 70 

Retrieves system parameter values from the system 

configuration file Retrieves system parameter values from the 

system configuration file getconfig(8) 87 

Runs a mainframe and IOS-E initialization and 

confidence test Runs a mainframe and IOS-E initialization and 

confidence test mfinit(8) 101 

Screen color Monitors the mainframe status and sets the OWS-E 

background color craymon(8) 35 

Sends an echo packet to an IOP from the OWS-E Sends an echo packet to an IOP from the OWS-E eping(8) 71 
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Sets or displays the fy driver's IP Interface 

Routing table Sets or displays the fy driver's IP Interface 

Routing table fyroute(8) 84 

SMARTE Monitors the OWS-E system for SMARTE smdemon(8) 112 

SMARTE Terminates the SMARTE OWS-E system monitor 

daemon smdstop(8) 113 

SMARTE monitor (restarting) Restarts the IOS-E error-logging, heartbeat, 

SMARTE, and CPU monitors emon(8) 70 

smdemon Monitors the OWS-E system for SMARTE smdemon(8) 1 12 

smdstop Terminates the SMARTE OWS-E system monitor 

daemon smdstop(8) 113 

SNMP network monitor Invokes the SNMP network monitor xsnmpmon(8) 115 

Starts the mainframe CPUs from the OWS-E Starts the mainframe CPUs from the OWS-E mfstart(8) 103 

Stopping the mainframe Issues a CPU master clear to stop the mainframe cpuhalt(8) 33 

System configuration file (retrieving from) Retrieves system parameter values from the 

system configuration file getconfig(8) 87 

Takes a dump image of UNICOS Takes a dump image of UNICOS dumpsys(8) 38 

Takes a UNICOS panic dump Takes a UNICOS panic dump cpupanic(8) 34 

Telnet and zip Acts as the terminal interface to a running CPU zip(8) 127 

Terminal interface Acts as the terminal interface to a running CPU zip(8) 127 

Terminates the SMARTE OWS-E system monitor 

daemon Terminates the SMARTE OWS-E system monitor 

daemon smdstop(8) 113 

Trace buffer information Formats raw trace buffer information extracted 

from fy driver modules fyformat(8) 83 

UNICOS console Acts as the terminal interface to a running CPU zip(8) 127 

UNICOS dump Forces a UNICOS dump cpudump(8) 32 

UNICOS panic dump Takes a UNICOS panic dump cpupanic(8) 34 

Usurping tty lines Acts as the terminal interface to a running CPU zip(8) 127 

Usurping tty lines Validates CRI tty lines for users lapdaemon(8) 96 

Validates CRI tty lines for users Validates CRI tty lines for users lapdaemon(8) 96 

Verifying the SWI connection Sends an echo packet to an IOP from the OWS-E eping(8) 71 

Weekly backups Performs a full (level-0) backup of the OWS-E 

file systems dumpwkly(8) 41 

xsnmpmon Invokes the SNMP network monitor xsnmpmon(8) 115 

zip Acts as the terminal interface to a running CPU zip(8) 127 
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Your reactions to this manual will help us provide you with better documentation. Please take a moment to 
complete the following items, and use the blank space for additional comments. 

List the operating systems and programming languages you have used and the years of experience with 
each. 



Your experience with Cray Research computer systems: 



_0-l year 



.1-5 year 



_5+years 



How did you use this manual: in a class as a tutorial or introduction as a procedural guide 

as a reference for troubleshooting other 



Please rate this manual on the following criteria: 



Accuracy 

Appropriateness (correct technical level) 
Accessibility (ease of finding information) 
Physical qualities (binding, printing, illustrations) 
Terminology (correct, consistent, and clear) 
Number of examples 
Quality of examples 
Index 



Excellent 
4 
4 
4 
4 
4 
4 
4 
4 



Poor 
1 
1 
1 
1 
1 
1 
1 
1 



Please use the space below for your comments about this manual. Please include general comments about 
the usefulness of this manual. If you have discovered inaccuracies or omissions, please specify the number 
of the page on which the problem occurred. 
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Title - 



Company — 
Telephone — 
Today's date 



Address ■ 
City 



State/Country . 
Zip code 



Electronic mail address 
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